Java Evangelist John Yeary: 2011

Saturday, December 31, 2011

JAX-RS Tip of the Day: Using YUI2 and YUI3 DataTables with Jersey and jQuery

This is a great example (if I do say so myself) that demonstrates some really cool capabilities of Jersey combined with Yahoo User Interface versions 2 and 3 combined with jQuery to demonstrate interoperability of multiple technologies.

The example code that I have included uses GlassFish 3.1.1 with Jersey 1.11 and was developed using NetBeans 7.1 RC2. The data is from the default sample database included in NetBeans. Here is the code: jsonp-database.zip

The YUI2, YUI3, and jQuery libraries are provided by Yahoo and Google CDN. This is a further example of a truly RESTful application where the application is provided as a mashup of multiple web resources.

Yahoo User Interface (YUI) is an incredibly well developed UI framework for the web. The DataSource implementation is easy to use and is extremely adaptable. It is also very stable, and Yahoo eats its own dogfood like Google so it is battle tested. YUI3 is the next generation code, and the DataTable implementation includes a number of new features.

jQuery is an extremely popular Javascript framework with great AJAX functionality. I have included two examples (YUI2/YUI3) in which jQuery provides JSON data to the Yahoo DataSource.

Jersey provides the heavy lifting. In all of the examples I provide the data in a variety of formats, but I focus on providing both JSON and JSONP. JSONP allows us to use have cross-domain capabilities. The code also demonstrates how to use Jettison to encapsulate POJOs. The best part is that the data can be tested not only using your browser, but can also be tested using curl. This provides a very simple visual means of verifying data.

So what does it look like... look at the images below. The results speak for themselves.

YUI2 DataTable using JSP

YUI3 DataTable with JSONP and JAX-RS (Jersey)

Now for the most important part, how do you get here.

Technical Details

The CustomerFacadeREST class is the most interesting. The JSP and HTML pages have the details of how to use the various YUI DataSources along with jQuery. I will not print the pages out, and suggest that you simply download the code and examine it.

CustomerFacadeREST.java

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

/*
 * Copyright 2011 Blue Lotus Software, LLC.
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example.jaxrs.resources;
 
import com.bluelotussoftware.example.jaxrs.model.Customer;
import com.sun.jersey.api.json.JSONWithPadding;
import java.util.List;
import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.ws.rs.*;
import javax.ws.rs.core.GenericEntity;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import org.codehaus.jettison.json.JSONArray;
import org.codehaus.jettison.json.JSONException;
import org.codehaus.jettison.json.JSONObject;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
@Stateless
@Path("customers")
public class CustomerFacadeREST extends AbstractFacade<customer> {
 
    @PersistenceContext(unitName = "demoPU")
    private EntityManager em;
 
    public CustomerFacadeREST() {
        super(Customer.class);
    }
 
    @POST
    @Override
    @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public void create(Customer entity) {
        super.create(entity);
    }
 
    @PUT
    @Override
    @Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public void edit(Customer entity) {
        super.edit(entity);
    }
 
    @DELETE
    @Path("{id}")
    public void remove(@PathParam("id") Integer id) {
        super.remove(super.find(id));
    }
 
    @GET
    @Path("json/{id}")
    @Produces({MediaType.APPLICATION_JSON})
    public JSONObject findJSONObject(@PathParam("id") Integer id) {
        Customer c = super.find(id);
        JSONObject jSONObject = new JSONObject();
        try {
            jSONObject.put("customerId", c.getCustomerId());
            jSONObject.put("name", c.getName());
            jSONObject.put("addressLine1", c.getAddressline1());
            jSONObject.put("addressLine2", c.getAddressline2());
            jSONObject.put("city", c.getCity());
            jSONObject.put("state", c.getState());
            jSONObject.put("phone", c.getPhone());
            jSONObject.put("fax", c.getFax());
            jSONObject.put("email", c.getEmail());
            jSONObject.put("creditLimit", c.getCreditLimit());
        } catch (JSONException ex) {
            throw new WebApplicationException(ex, Response.Status.INTERNAL_SERVER_ERROR);
        }
        return jSONObject;
    }
 
    @GET
    @Path("{id}")
    @Produces({"application/javascript", "application/ecmascript", "application/x-ecmascript",
        "application/x-javascript"})
    public JSONWithPadding find(@PathParam("id") Integer id,
            @QueryParam(value = "callback") String callback) {
        return new JSONWithPadding(super.find(id), callback);
    }
 
    @GET
    @Produces({"application/javascript", "application/ecmascript", "application/x-ecmascript",
        "application/x-javascript"})
    public JSONWithPadding getCustomers(@QueryParam("callback") String callback) {
        return new JSONWithPadding(new GenericEntity<List<customer>>(super.findAll()) {
        }, callback);
    }
 
    @GET
    @Produces({MediaType.APPLICATION_JSON})
    @Path("json")
    public List<customer> getCustomersJSON() {
        return super.findAll();
    }
 
    @GET
    @Produces({"application/javascript", "application/ecmascript", "application/x-ecmascript",
        "application/x-javascript"})
    @Path("alternate")
    public JSONWithPadding getCustomersAlternate1(@QueryParam("callback") String callback) {
        return new JSONWithPadding(super.findAll(), callback);
    }
 
    //FIXME This returns an unexpected result of toString() on the Customer objects.
    @GET
    @Produces({"application/javascript", "application/ecmascript", "application/x-ecmascript",
        "application/x-javascript"})
    @Path("alternate2")
    public JSONWithPadding getCustomersAlternate2(@QueryParam(value = "callback") String callback) {
        JSONArray jSONArray = new JSONArray(super.findAll());
        return new JSONWithPadding(jSONArray, callback);
    }
 
    @GET
    @Path("{from}/{to}")
    @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public List<customer> findRange(@PathParam("from") Integer from, @PathParam("to") Integer to) {
        return super.findRange(new int[]{from, to});
    }
 
    @GET
    @Path("count")
    @Produces("text/plain")
    public String countREST() {
        return String.valueOf(super.count());
    }
 
    @java.lang.Override
    protected EntityManager getEntityManager() {
        return em;
    }
}

CODE

Here is the code: jsonp-database.zip

JAX-RS Tip of the Day: Changing JSON-JAXB Default Mapping

JSON-JAXB marshalling and un-marshalling by default uses a MAPPED configuration by default. However this can be changed by creating a @Provider which can change the default JSONConfiguration.

The example below changes the configuration to use BadgerFish which provides a better representation of an XML document. This representation does not provide the visual clarity that JSON generally provides, and is not generally human readable beyond basic notation. However, as noted that is not the point.

JSONJAXBContextResolver.java

/*
 * Copyright 2011 Blue Lotus Software, LLC.
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example.jaxrs.providers;
 
import com.bluelotussoftware.example.jaxrs.model.Customer;
import com.sun.jersey.api.json.JSONConfiguration;
import com.sun.jersey.api.json.JSONJAXBContext;
import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;
import javax.ws.rs.ext.ContextResolver;
import javax.ws.rs.ext.Provider;
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
@Provider
public class JSONJAXBContextResolver implements ContextResolver<JAXBContext> {
 
    private final JAXBContext context;
    private final Set<Class> types;
    private final Class[] cs = {Customer.class};
 
    public JSONJAXBContextResolver() throws JAXBException {
        this.types = new HashSet(Arrays.asList(cs));
        //Change the JSONConfiguration below to chnage the mapping type.
        this.context = new JSONJAXBContext(JSONConfiguration.badgerFish().build(), cs);
    }
 
    @Override
    public JAXBContext getContext(Class<?> type) {
        return (types.contains(type)) ? context : null;
    }
}

This class specifically handles the Customer object, and maps it to use BadgerFish.

1	`curl -X GET -H` `"Accept: application/json"` `http://localhost:8080/jsonp-database/resources/customers/json/1`

Output:

1	`{"customerId":1,"name":"Jumbo Eagle Corp","addressLine1":"111 E. Las Olivas Blvd","addressLine2":"Suite 51","city":"Fort Lauderdale","state":"FL","phone":"305-555-0188","fax":"305-555-0189","email":"jumboeagle@example.com","creditLimit":100000}`

Friday, December 30, 2011

JAX-RS Tip of the Day: Automatic Mapping of Jettison JSON Objects

One of the more interesting features in JAX-RS (Jersey) is the ability to automatically "wrap" POJOs. This combined with automatic wrapping of JAXB annotated beans, and using Jackson to create JSON objects is a powerful mix. However, sometimes we want to wrap an object, and add some additional metadata.

This tip is a very simple tip which allows you to create Jettison JSONObject, and JSONArray objects to create new objects, "wrap" existing objects, or add additional metadata. I mention "wrap" the objects, please don't confuse this with JSONP.

To enable automatic POJO mapping, and Jettison objects add the following to the web.xml

<servlet>
    <servlet-name>ServletAdaptor</servlet-name>
    <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
    <init-param>
        <description>
            Allow automatic POJO Mapping features.
        </description>
        <param-name>com.sun.jersey.api.json.POJOMappingFeature</param-name>
        <param-value>true</param-value>
    </init-param>
    <init-param>
        <description>
            Set the packages to point to resources which you want to allow 
            mapping of Jettison based objects. Separate the values for multiple
            packages with a comma (,).
        </description>
        <param-name>com.sun.jersey.config.property.packages</param-name>
        <param-value>com.bluelotussoftware.example.jaxrs.resources</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

This simple configuration will give you considerable flexibility in how you handle your objects. This will now allow you to produce JSONObjects like the code example below:

@GET
@Path("{id}")
@Produces({MediaType.APPLICATION_JSON})
public JSONObject findJSONObject(@PathParam("id") Integer id) {
    Customer c = super.find(id);
    JSONObject jSONObject = new JSONObject();
    try {
        jSONObject.put("customerId", c.getCustomerId());
        jSONObject.put("name", c.getName());
        jSONObject.put("addressLine1", c.getAddressline1());
        jSONObject.put("addressLine2", c.getAddressline2());
        jSONObject.put("city", c.getCity());
        jSONObject.put("state", c.getState());
        jSONObject.put("phone", c.getPhone());
        jSONObject.put("fax", c.getFax());
        jSONObject.put("email", c.getEmail());
        jSONObject.put("creditLimit", c.getCreditLimit());
    } catch (JSONException ex) {
        throw new WebApplicationException(ex, Response.Status.INTERNAL_SERVER_ERROR);
    }
    return jSONObject;
}

Wednesday, December 28, 2011

Multiple File Upload Examples

I received an email today from a developer who was looking for examples of how to do multiple file uploads. I had written a post previously Multiple File Upload Options which detailed some of the options available. The option I recommended was Andrew Valums ajax-upload. The developer had indicated that the servlet I contributed was not working with Internet Explorer correctly. He was correct.

The code that I provided to Andrew Vallums was expecting application/octet-stream. However Internet Explorer and Opera were sending multipart/form-data. This would not work with the servlet example I posted since the handling mechanism is considerably different.

Alan O'Driscoll and I discovered the differences using Wireshark to sniff the packets and see what was being sent over the wire. As a result, I have written a new servlet to handle the differences between browsers.

The example application I wrote has a number of different examples included with minor variations on the theme. The version most folks are interested in is example #6 which uses the ajax-upload, and the new servlet. Here is the Apache Maven project which was developed on NetBeans and tested on GlassFish v 2.1.1.

Here is a link to the Mercurial project: apache-file-upload-ee5.

Here is another resource for file upload plugins: 9 Powerful jQuery File Upload Plugins. I discovered it while I was looking for something else.

MultiContentServlet.java

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

package com.bluelotussoftware.apache.commons.fileupload.example;
 
import java.io.*;
import java.util.List;
import java.util.ListIterator;
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.apache.commons.io.IOUtils;
 
/**
 *
 * @author John Yeary
 * @author Allan O'Driscoll
 * @version 1.0
 */
public class MultiContentServlet extends HttpServlet {
 
    private static final long serialVersionUID = -2045199313944348406L;
    private static final String DESTINATION_DIR_PATH = "files";
    private static String realPath;
    private static final boolean debug = false;
 
    /**
     * {@inheritDoc}
     *
     * @param config
     * @throws ServletException
     */
    @Override
    public void init(ServletConfig config) throws ServletException {
        super.init(config);
        realPath = getServletContext().getRealPath(DESTINATION_DIR_PATH) + "/";
    }
 
    /**
     * Handles the HTTP
     * <code>POST</code> method.
     *
     * @param request servlet request
     * @param response servlet response
     * @throws ServletException if a servlet-specific error occurs
     * @throws IOException if an I/O error occurs
     */
    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        PrintWriter writer = null;
        InputStream is = null;
        FileOutputStream fos = null;
 
        try {
            writer = response.getWriter();
        } catch (IOException ex) {
            log(MultiContentServlet.class.getName() + "has thrown an exception: " + ex.getMessage());
        }
 
        boolean isMultiPart = ServletFileUpload.isMultipartContent(request);
 
        if (isMultiPart) {
            log("Content-Type: " + request.getContentType());
            // Create a factory for disk-based file items
            DiskFileItemFactory diskFileItemFactory = new DiskFileItemFactory();
 
            /*
             * Set the file size limit in bytes. This should be set as an
             * initialization parameter
             */
            diskFileItemFactory.setSizeThreshold(1024 * 1024 * 10); //10MB.
 
 
            // Create a new file upload handler
            ServletFileUpload upload = new ServletFileUpload(diskFileItemFactory);
 
            List items = null;
 
            try {
                items = upload.parseRequest(request);
            } catch (FileUploadException ex) {
                log("Could not parse request", ex);
            }
 
            ListIterator li = items.listIterator();
 
            while (li.hasNext()) {
                FileItem fileItem = (FileItem) li.next();
                if (fileItem.isFormField()) {
                    if (debug) {
                        processFormField(fileItem);
                    }
                } else {
                    writer.print(processUploadedFile(fileItem));
                }
            }
        }
 
        if ("application/octet-stream".equals(request.getContentType())) {
            log("Content-Type: " + request.getContentType());
            String filename = request.getHeader("X-File-Name");
 
            try {
                is = request.getInputStream();
                fos = new FileOutputStream(new File(realPath + filename));
                IOUtils.copy(is, fos);
                response.setStatus(HttpServletResponse.SC_OK);
                writer.print("{success: true}");
            } catch (FileNotFoundException ex) {
                response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
                writer.print("{success: false}");
                log(MultiContentServlet.class.getName() + "has thrown an exception: " + ex.getMessage());
            } catch (IOException ex) {
                response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
                writer.print("{success: false}");
                log(MultiContentServlet.class.getName() + "has thrown an exception: " + ex.getMessage());
            } finally {
                try {
                    fos.close();
                    is.close();
                } catch (IOException ignored) {
                }
            }
 
            writer.flush();
            writer.close();
        }
    }
 
    private void processFormField(FileItem item) {
        // Process a regular form field
        if (item.isFormField()) {
            String name = item.getFieldName();
            String value = item.getString();
            log("name: " + name + " value: " + value);
        }
    }
 
    private String processUploadedFile(FileItem item) {
        // Process a file upload
        if (!item.isFormField()) {
            try {
                item.write(new File(realPath + item.getName()));
                return "{success:true}";
            } catch (Exception ex) {
                log(FileUploadServlet.class.getName() + " has thrown an exception: " + ex.getMessage());
            }
        }
        return "{success:false}";
    }
 
    /**
     * Returns a short description of the servlet.
     *
     * @return a String containing servlet description
     */
    @Override
    public String getServletInfo() {
        return "Handles file upload data from application/octet-stream, and multipart/form-data.";
    }
}

Sunday, December 18, 2011

RichFaces 4.1.0 Final on NetBeans 7.1 IDE

I created a video which demonstrates how to add RichFaces 4.1.0 Final as a component library in NetBeans 7.1. The video details how to add the required jars to create the library, demonstrates code completion, and finally deployment to GlassFish 3.1.1 for display.

In the video I take advantage of using my local Apache Maven repository which includes all of the dependencies required.

The list below includes references to the required libraries and versions. There is a link to the video as well.

sac-1.3.jar
guava-r08.jar
cssparser-0.9.5.jar
richfaces-core-api-4.1.0.Final.jar
richfaces-core-impl-4.1.0.Final.jar
richfaces-components-api-4.1.0.Final.jar
richfaces-components-ui-4.1.0.Final.jar

NetBeans 7.1 Library Manager

Friday, December 16, 2011

JAX-RS Tip of the Day: NetBeans Project Layout Recommendations

When developing a JAX-RS project using NetBeans, I have a couple of simple recommendations. This will hopefully save you some time up front.

First create a Java → Java Class Library project.
This project will be used to contain classes we expect to share between the service and the client.
Create a second project Java Web → Web Application.
This project will serve as our REST service application.
Add the first project to the second project.
(Optional) Create a Java → Java Application
This final project will be used for as our client application.
(Optional) Add the first project to the client project.

The most important part of the recommendation is to make sure that you have a separate library project. The shared code can later be used in multiple projects without refactoring later.

Here is an example project that meets the recommendations above. It was created with NetBeans 7.1 RC2.

JAX-RS Tip of the Day: Use GenericEntity<T> for Collections

A common requirement is to generate List<T> for a REST service. The JAX-RS client must retrieve this, but the question is how to use it. The easiest method to use a GenericType<T>.

As an example, we have a service which returns a List<Widget>;. The client application will need to wrap the returned List<Widget>. We accomplish this as shown below using GenericType<List<Widget>>(){}.

public List<widget> getXml_XML() throws UniformInterfaceException {
          WebResource resource = webResource;
          return resource.accept(MediaType.APPLICATION_XML).
                  get(new GenericType<List<widget>>() {
          });
      }

The GenericType<List<Widget>>(){} allows us to wrap the List<Widget>, and return the <code>Collection</code> object we are really interested in. So remember, if you need to wrap a <code>Collection</code> use GenericType<T>.

Thursday, December 15, 2011

Java Tip of the Day: Using ProcessBuilder to Make System Calls

A few years ago I posted an article on how to execute OS level system calls using the Runtime class. When I wrote that article I was using a methodology which has been around since the 1.0 days of Java. In Java 5 Standard Edition, and subsequently improved in Java 6 and Java 7, is a class called ProcessBuilder. This class is a significant improvement over using the Runtime class. It provides complete flexibilty around the system call in terms of environment including directories, input and output streams, and execution.

Here is the NetBeans 7.1 Apache Maven project: process-builder-example.zip

/*
 * Copyright 2011 Blue Lotus Software, LLC.
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example;
 
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
 
/**
 * <p>
{@link java.lang.ProcessBuilder} Example Application to execute commands
 * from command line arguments.</p>
*
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class App {
 
    private static void copy(InputStream in, OutputStream out) throws IOException {
        while (true) {
            int c = in.read();
            if (c == -1) {
                break;
            }
            out.write((char) c);
        }
    }
 
    public static void main(String[] args) throws IOException, InterruptedException {
 
        if (args.length == 0) {
            System.out.println("You must supply at least one argument.");
            return;
        }
 
        ProcessBuilder processBuilder = new ProcessBuilder(args);
        processBuilder.redirectErrorStream(true);
 
        Process process = processBuilder.start();
        copy(process.getInputStream(), System.out);
        process.waitFor();
        System.out.println("Exit Status : " + process.exitValue());
    }
}

When I execute it from NetBeans I get something like this:

[exec:exec]
total 24
drwxr-xr-x  12 jyeary  staff   408B Dec 15 08:19 .hg
-rw-r--r--   1 jyeary  staff    52B Dec 15 08:08 .hgignore
-rw-r--r--   1 jyeary  staff   1.7K Dec 15 07:59 nbactions.xml
-rw-r--r--   1 jyeary  staff   2.0K Dec 15 08:19 pom.xml
drwxr-xr-x   4 jyeary  staff   136B Dec 14 23:31 src
drwxr-xr-x   4 jyeary  staff   136B Dec 15 08:35 target
Exit Status : 0

Wednesday, December 14, 2011

Subversion to Mercurial Migration: Using --splicemap to Map Branches and Merges

I am in the process of migrating all of my existing code projects to Mercurial from Subversion. However, the process has some snags associated with it. The biggest snag is that Mercurial does not understand the branching and merging process which is common in most Subversion repositories. If you convert a repository from Subversion to Mercurial the timeline indicates the branch, but does not associate it with the parent (default head). This results in "floating" heads (branches). One blogger I found called it a multi-headed Hydra.

Floating Heads (Branches)

What we really want is to show consistency, and progression. We want to show the branches and merges that are stored Subversion in Mercurial. We don't want to lose that vital historical information.

So we now know what the problem is, but how do we fix it. It turns out that the convert extension method has a very poorly (read not useful at all) documented switch called splicemap. This allows us to map specific revisions in parent-child relationships.

In the Rock Hymas blog, they give an example of the format for our splicemap for Subversion. It looks like the following:

svn:<uuid>/path/to/module@revnum

However, he ends short of what to do with this information, or how to obtain it. The article is good on explanation of the issue, but not on how to solve it. I will detail a solution and show you how I did it. I will also show how to use a splicemap "so that others may live"... oh wait that is the US Air Force Pararescue motto. I will show a working example to make a point.

Process

The first thing we will need is the UUID from Subversion. This can be obtained using the svnlook command.

apple1:~ root# svnlook uuid /usr/local/svnhome/
dbc3d074-2bd0-48a6-aa6f-e69526dc1c92

The UUID is absolutely vital. It will be different for every repository.

Next, we need a log of the activity for the project we are interested in mapping. We will use the svn log -v command to get the details. The results will look something like this. I have shortened my output to just a couple of relevant versions which we will need.

------------------------------------------------------------------------
r417 | jyeary | 2011-12-11 06:28:21 -0500 (Sun, 11 Dec 2011) | 1 line
Changed paths:
   M /MailService/trunk/MailService/build.xml
   M /MailService/trunk/MailService/nbproject/build-impl.xml
   M /MailService/trunk/MailService/nbproject/genfiles.properties
   A /MailService/trunk/MailService/nbproject/jaxws-build.xml
   M /MailService/trunk/MailService/nbproject/project.properties

Merged 3.0 tag to trunk, and updated NetBeans project files.

------------------------------------------------------------------------
r137 | jyeary | 2008-09-05 19:15:25 -0400 (Fri, 05 Sep 2008) | 1 line
Changed paths:
   M /MailService/branches/3.0-DEV/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/MailServiceBean.java

Updated properties.
------------------------------------------------------------------------
r128 | jyeary | 2008-09-02 17:51:49 -0400 (Tue, 02 Sep 2008) | 1 line
Changed paths:
   M /MailService/trunk/MailService
   M /MailService/trunk/MailService/nbproject/project.properties
   M /MailService/trunk/MailService/src/conf/sun-ejb-jar.xml
   D /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/MailService.java
   M /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/MailServiceBean.java
   D /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/MailServiceRemote.java
   A /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/local (from /MailService/branches/2.0-DEV/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/local:124)
   R /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/local/MailServiceLocal.java (from /MailService/branches/2.0-DEV/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/local/MailServiceLocal.java:124)
   A /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/remote (from /MailService/branches/2.0-DEV/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/remote:124)
   R /MailService/trunk/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/remote/MailServiceRemote.java (from /MailService/branches/2.0-DEV/MailService/src/java/com/bluelotussoftware/mail/ee/ssb/remote/MailServiceRemote.java:124)

merged 2.0 changes into trunk.
------------------------------------------------------------------------

Next we determine how to splice it together. We want to ensure that the parents, and children match up. The file format is: child parent with a space between the child and parent. We may also provide an additional parent which is separated by a comma such as child parent1,parent2

So the first splice in the splicemap for the 2.0-DEV branch looks like this:

svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/2.0-DEV@95 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@57

Note: I am splicing the branch to the trunk (parent).

Using the hg convert --datesort --splicemap splicemap1 http://10.0.1.2/svn/MailService resulted in the following output:

assuming destination MailService-hg
initializing destination MailService-hg repository
svn: cannot probe remote repository, assume it could be a subversion repository. Use --source-type if you know better.
scanning source...
sorting...
converting...
21 creating structure
20 Moving project out of MailServiceApplication
19 Fixed javadoc
18 [Netbeans SVN client generated message: create a new folder for the copy]: '
spliced in ['svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@57'] as parents of svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/2.0-DEV@95
17 2.0 development branch
16 1. Updated version numbers.
15 Added new sendMessage() method that allows for different MIME types.
14 1.Added new MimeMessage format to @Remote
13 1.Added new MimeMessage format to @Local
12 1. Added new MimeMessage format
11 Updated project properties
10 1. Created a new local package
9 1. Updated Javadocs
8 Updated project properties
7 merged 2.0 changes into trunk.
6 Adding new development branch
5 Adding trunk to 3.0 Development branch
4 Removed @Local interface implementation from bean.
3 Removed @Local interface.
2 Removed directory.
1 Updated properties.
0 Merged 3.0 tag to trunk, and updated NetBeans project files.
updating tags

More importantly, the result is what we are looking for. See the image below.

Branch

Alright, that solved the branching problem, but the more difficult issue is the merge. I was banging my head on my desk when I came across this Nabble post by Bruce Frederiksen which gave me the clue I needed to merge the branch back to the default head.

We need to tell Mercurial what the parent branches are for the merge from the perspective of the repository. In this case we want the revision at 57 as one parent from the branch above, and the other to be the revision we merge at on the default head. In this case revision 123. We also need to reverse the order (remember what I said about perspective... thanks Bruce). Our new splice looks like:

svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/2.0-DEV@95 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@57
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@127 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@57,\
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/2.0-DEV@123

Note: I am splicing the trunk@127 to the trunk@57 and branch@123. This is the trick.

Note: The splices are wrapped to fit on the page, the actual file requires each complete splice to be on a new line.

The result when we run the hg convert command again results in merging the branch back to the default head.

Branch-Merge

Finally, I make the remaining splices to complete the mapping which look like:

svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/2.0-DEV@95 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@57
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@127 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@57,\
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/2.0-DEV@123
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/3.0-DEV@129 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@128
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@417 svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/trunk@128,\
svn:dbc3d074-2bd0-48a6-aa6f-e69526dc1c92/MailService/branches/3.0-DEV@137

Note: The splices are wrapped to fit on the page, the actual file requires each complete splice to be on a new line.

This results in the final completed completed product.

Completed

Conclusion

I hope that this explains how to effectively use a splicemap to branch and merge your Subversion repository into Mercurial. I hope that this saves some other unfortunate developers from trying to figure out a really cool, but poorly documented feature of the convert extension.

Tuesday, December 13, 2011

Secure Mercurial in GlassFish using SSL

A friend of mine, Wade Chandler, contacted me the other day to ask about implementing security (SSL) for Mercurial on GlassFish. Wade is NetBeans Dream Team member, and all-around great guy. I told him I would figure it out, and tell him how to do it. I also decided that I would explain to everyone how to take advantage of this cool functionality using GlassFish 3.1.1 and NetBeans 7.1 RC 2.

In a previous blog entry, Mercurial on GlassFish 2.1 Using Multiple Repositories, I successfully deployed Mercurial repositories on GlassFish. This time I have given everything a Java EE 6 upgrade.

One of the great aspects of using GlassFish to provide SSL is that we don't require messy configuration in Python and Mercurial to implement SSL. GlassFish handles the security for us. The only thing that the end client users will want to do is add the server fingerprint to the .hgrc file in their home directory. This will remove any warnings about a missing server fingerprint, or cacerts file.

If you have used Mercurial on Apache HTTPD Server, along with cacerts, and client certificates... this will make you make the switch immediately.

Requirements:

You can create your own web project in NetBeans, but the Mercurial.zip is a self-contained Mercurial repository, and NetBeans project which can serve as the basis for your own server with very little modification. I would simply use my project as the basis for your own deployment.

Note: The requirements include repos.zip which is optional. The repos.zip contains sample mercurial repos which are required for the demo.

Procedures

Configure GlassFish

Start the GlassFish administration console.
Go to Configuration → server-config → Security → Realms → file.
Note: You may create your own realm, this is just for demonstration purposes.
Click on Manage Users.

GlassFish Security Configuration
Click on New. Add a user called mercurial in a group called Mercurial Users with the password hg.
Note: Please change the username, group, and password for production.
The server configuration is complete.

NetBeans

Using NetBeans open the Mercurial project from the requirements link above.
There are four files in the project (simple huh?) which control the behavior of the Mercurial repository on GlassFish: hgweb.cgi, hgweb.config, web.xml, and glassfish-web.xml.
The hgweb.cgi should not need to be modified under normal circumstances.
Open the hgweb.config file. Make any changes that you would like to customize the application. Pay particular attention to the location of the repositories.
There are two examples: (1) using the "/" along with a * on the end of the file path will list all repositories in the specified directory, and (2) a specific listing.

Note: Please note that allow_push = * and push_ssl = false are set. This will allow push to the server and let GlassFish take care of the SSL.

The web.xml file has been modified to add security constraints for the alpha, and beta example repositories.
The alpha repository has security only on PUT, POST, and DELETE.
The beta repository will not allow you to perform any actions without logging into the server.
The gamma repository has no security constraints.

Note: You will need to modify the security constraints to meet your requirements.

Note: You secure the entire repository by adding:
<url-pattern>/cgi-bin/hgweb.cgi/*</url-pattern>.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         version="3.0">
    <servlet>
        <servlet-name>cgi</servlet-name>
        <servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>
        <init-param>
            <param-name>debug</param-name>
            <param-value>1</param-value>
        </init-param>
        <init-param>
            <param-name>cgiPathPrefix</param-name>
            <param-value>WEB-INF/cgi</param-value>
        </init-param>
        <load-on-startup>5</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>cgi</servlet-name>
        <url-pattern>/cgi-bin/*</url-pattern>
    </servlet-mapping>
    <session-config>
        <session-timeout>
            30
        </session-timeout>
    </session-config>
    <welcome-file-list>
        <welcome-file>cgi-bin/hgweb.cgi</welcome-file>
    </welcome-file-list>
    <security-constraint>
        <display-name>Alpha</display-name>
        <web-resource-collection>
            <web-resource-name>alpha</web-resource-name>
            <description/>
            <url-pattern>/cgi-bin/hgweb.cgi/alpha/*</url-pattern>
            <http-method>PUT</http-method>
            <http-method>POST</http-method>
            <http-method>DELETE</http-method>
        </web-resource-collection>
        <auth-constraint>
            <description/>
            <role-name>Mercurial Users</role-name>
        </auth-constraint>
    </security-constraint>
    <security-constraint>
        <display-name>Beta</display-name>
        <web-resource-collection>
            <web-resource-name>beta</web-resource-name>
            <description/>
            <url-pattern>/cgi-bin/hgweb.cgi/beta/*</url-pattern>
        </web-resource-collection>
        <auth-constraint>
            <description/>
            <role-name>Mercurial Users</role-name>
        </auth-constraint>
    </security-constraint>
    <login-config>
        <auth-method>BASIC</auth-method>
        <realm-name>file</realm-name>
    </login-config>
    <security-role>
        <description/>
        <role-name>Mercurial Users</role-name>
    </security-role>
</web-app>

The glassfish-web.xml is used to map the security role(s) to the file realm on the GlassFish server.

?
1
2
3
4
<security-role-mapping>
<role-name>Mercurial Users</role-name>
<group-name>Mercurial Users</group-name>
</security-role-mapping>
Clean, build, and Run the application.
When the application successfully deploys, go to the secure connection on https://localhost:8181/Mercurial. It may prompt you to accept the server certificate. Accept it.
You should see something like the image below:

Mercurial Repositories
Click on the beta repository. It should prompt you to login.
Congratulations you are running Mercurial on GlassFish securely.

Note: To secure the application completely, you should disable the non-secure http port listener on port 8080, or redirect requests to the secure port.

Verification

It would be unwise to accept that the application is secure without verification.

I made this demonstration video to prove the connection is secure. The demonstration shows both insecure and secure connections to the repository. I use Wireshark to sniff the connection, and pull the repository from the command line using hg clone.

Conclusion

Mercurial is a great distributed source control system. Its ease of use is further enhanced by using GlassFish 3.1.1 to provide the front end to your repository. It also simplifies the deployment, and use models.

Friday, December 02, 2011

Java Tip of the Day: Generic JAXB Map<K, V> XmlAdapter

There are a couple of well-known issues with using Map<K,V> with JAXB. First, JAXB does not like interfaces. Second, it considers a Map<K,V> to be a bean so it does not handle the internal implementation. The JAXB JIRA Issue is here JAXB-223

There are a number of articles published about how to adapt a Map<K,V> to work in JAXB. However, all of them I have seen are very specific mappings like Map<String,String>, or Map<Integer,String>, etc. None of them address the more specific generic case Map<K,V>. This example handles the more general case using generics. All the other examples I looked at online generally follow the example code from the XmlAdapter javadoc. The code snippet does not encapsulate the values, and generally does not adhere to good coding practices.

The process is to create an adapter is as follows:

Create an mapping entry for Map<K,V>. In our case, we will create one called: MapEntryType<K, V> which will map our generic types.
Next we create a value holder for our Map<K,V> which contains a List<MapEntryType<K, V>> of our entries. The value holder looks like MapType<K, V>
Finally, we create an adapter which extends XmlAdapter. In our case, it is very long since I am using Java 6. In Java 7, we can use the diamond <> operator to shorten it. The adapter is XmlGenericMapAdapter<K, V> extends XmlAdapter<MapType<K, V>, Map<K, V>>.

Note: Please note that the MapEntryType<K, V> has the @XmlAccessorType(XmlAccessType.PROPERTY) set to property and the getters are annotated as @XmlElement.

The NetBeans 7.1 RC1 Apache Maven project can be downloaded here: generic-jaxb-map-adapter.zip

MapEntryType<K, V>

package com.bluelotussoftware.jaxb.adapter;
 
import java.util.Map;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
 
/**
 *
 * @author John Yeary
 * @version 1.0
 */
@XmlAccessorType(XmlAccessType.PROPERTY)
public class MapEntryType<K, V> {
 
    private K key;
    private V value;
 
    public MapEntryType() {
    }
 
    public MapEntryType(Map.Entry<K, V> e) {
        key = e.getKey();
        value = e.getValue();
    }
 
    @XmlElement
    public K getKey() {
        return key;
    }
 
    public void setKey(K key) {
        this.key = key;
    }
 
    @XmlElement
    public V getValue() {
        return value;
    }
 
    public void setValue(V value) {
        this.value = value;
    }
}

MapType<K, V>

package com.bluelotussoftware.jaxb.adapter;
 
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
 
/**
 *
 * @author John Yeary
 * @version 1.0
 */
public class MapType<K, V> {
 
    private List<MapEntryType<K, V>> entry = new ArrayList<MapEntryType<K, V>>();
 
    public MapType() {
    }
 
    public MapType(Map<K, V> map) {
        for (Map.Entry<K, V> e : map.entrySet()) {
            entry.add(new MapEntryType<K, V>(e));
        }
    }
 
    public List<MapEntryType<K, V>> getEntry() {
        return entry;
    }
 
    public void setEntry(List<MapEntryType<K, V>> entry) {
        this.entry = entry;
    }
}

XmlGenericMapAdapter<K, V> extends XmlAdapter<MapType<K, V>, Map<K, V>>

package com.bluelotussoftware.jaxb.adapter;
 
import java.util.HashMap;
import java.util.Map;
import javax.xml.bind.annotation.adapters.XmlAdapter;
 
/**
 *
 * @author John Yeary
 * @version 1.0
 */
public class XmlGenericMapAdapter<K, V> extends XmlAdapter<MapType<K, V>, Map<K, V>> {
 
    @Override
    public Map<K, V> unmarshal(MapType<K, V> v) throws Exception {
        HashMap<K, V> map = new HashMap<K, V>();
 
        for (MapEntryType<K, V> mapEntryType : v.getEntry()) {
            map.put(mapEntryType.getKey(), mapEntryType.getValue());
        }
        return map;
    }
 
    @Override
    public MapType marshal(Map<K, V> v) throws Exception {
        MapType<K, V> mapType = new MapType<K, V>();
 
        for (Map.Entry<K, V> entry : v.entrySet()) {
            MapEntryType<K, V> mapEntryType = new MapEntryType<K, V>();
            mapEntryType.setKey(entry.getKey());
            mapEntryType.setValue(entry.getValue());
            mapType.getEntry().add(mapEntryType);
        }
        return mapType;
    }
}

Here is the output from our adapter.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<mapvalueholder>
    <map>
        <entry>
            <key xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Beta</key>
            <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Beta</value>
        </entry>
        <entry>
            <key xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Alpha</key>
            <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Alpha</value>
        </entry>
        <entry>
            <key xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Delta</key>
            <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Delta</value>
        </entry>
        <entry>
            <key xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Epsilon</key>
            <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Epsilon</value>
        </entry>
        <entry>
            <key xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Gamma</key>
            <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:type="xs:string">Gamma</value>
        </entry>
    </map>
</mapValueHolder>

We take advantage of JAXB to provide automatic XML Schema definitions for our keys and values. The only problem with this approach is that it is very "chatty". It provides a schema definition for each key and value.

If you know that you are going to be using simple types, it is more appropriate to use a specific type rather than using generics. We would replace all of the <K, V> with <String, String>. This will remove all of the schema definitions and produce an output which is much cleaner. The String adapters are included in the source code for further review.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<mapvalueholder>
    <map>
        <entry>
            <key>Beta</key>
            <value>Beta</value>
        </entry>
        <entry>
            <key>Alpha</key>
            <value>Alpha</value>
        </entry>
        <entry>
            <key>Delta</key>
            <value>Delta</value>
        </entry>
        <entry>
            <key>Epsilon</key>
            <value>Epsilon</value>
        </entry>
        <entry>
            <key>Gamma</key>
            <value>Gamma</value>
        </entry>
    </map>
</mapValueHolder>

Coding Tip of the Day: Using Map<?,?> Collections

I was working on some code in the last few days where I came across a protected Map map instance variable. I examined the code and javadocs which indicated that the intent was to provide a mapping of keys and values. However the actual implementation was setting the keys and values to the same value. This again is not really an issue. However, the usage of the Map was incorrect.

See if you can determine the issue from the code below.

...
 
private static MapValueHolder<String, String> me;
 
    public static void main(String[] args) {
 
        me = new MapValueHolderImpl<String, String>();
        Map<String, String> mx = new HashMap<String, String>();
        mx.put("A", "A");
        mx.put("B", "B");
        mx.put("C", "C");
        me.setMap(mx);
 
 
        for (String key : me.getMap().keySet()) {
            System.out.println("MapValueHolder Key --> " + key);
        }
 
        for (String key : me.getMap().keySet()) {
            System.out.println(key + " --> " + me.getMap().get(key));
        }
...

The MapValueHolder<K,V> looks like the following.

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 * Copyright 2011 Bluelotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example;
 
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public abstract class MapValueHolder<K, V> {
 
    protected Map<K, V> map = new HashMap<K, V>();
 
    public MapValueHolder() {
    }
 
    public Map<K, V> getMap() {
        return Collections.unmodifiableMap(map);
    }
 
    public void setMap(Map<K, V> map) {
        this.map = new HashMap<K, V>(map);
    }
}

Here is the implementation.

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 * Copyright 2011 Bluelotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class MapValueHolderImpl<K, V> extends MapValueHolder<K, V> {
}

As a general rule, you should use the key to fetch the value. Even if you expect that the values are the same. Since the instance variable is protected it can be modified in a sub-class, or any class in the same package. Since we code to interfaces, or abstractions (super classes). We can not be sure that the implementation class we are provided does what we expect. In this case, it does what we expect.

MapValueHolder Key --> A
MapValueHolder Key --> B
MapValueHolder Key --> C
A --> A
B --> B
C --> C

Here we continue using another implementation.

...
        me = new KeyValueHolder<String, String>();
        me.setMap(mx);
 
 
        for (String key : me.getMap().keySet()) {
            System.out.println("MapValueHolder Key --> " + key);
        }
 
        for (String key : me.getMap().keySet()) {
            System.out.println(key + " --> " + me.getMap().get(key));
        }
...

This time the result looks different.

MapValueHolder Key --> A
MapValueHolder Key --> B
MapValueHolder Key --> C
A --> null
B --> null
C --> null

This is because our MapValueHolder<K,V> is different.

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 * Copyright 2011 Bluelotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example;
 
import java.util.HashMap;
import java.util.Map;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class KeyValueHolder<K, V> extends MapValueHolder<K, V> {
 
    public KeyValueHolder() {
    }
 
    @Override
    public void setMap(Map<K, V> map) {
        Map<K, V> mx = new HashMap<K, V>(map);
        for (K k : map.keySet()) {
            mx.put(k, null);
        }
        this.map = mx;
    }
}

Admittedly, the implementation above is a bit contrived. We really are getting is a Set<K>. In the next example, we get another result.

...
        me = new SingletonMapValueHolder<String, String>();
        me.setMap(mx);
 
        for (String key : me.getMap().keySet()) {
            System.out.println("MapValueHolder Key --> " + key);
        }
...

The result is considerably different.

MapValueHolder Key --> A
A --> A

Here is the implementation.

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 * Copyright 2011 Bluelotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example;
 
import java.util.Collections;
import java.util.Map;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class SingletonMapValueHolder<K, V> extends MapValueHolder<K, V> {
 
    public SingletonMapValueHolder() {
    }
 
    @Override
    public void setMap(Map<K, V> map) {
        this.map = Collections.singletonMap(
                map.entrySet().iterator().next().getKey(),
                map.entrySet().iterator().next().getValue());
    }
}

Again, this is a contrived result where we are just returning the first key and value in a Map<K,V>. Here is another example which demonstrates unexpected results.

1	`System.out.println(new` `Mod().MAP +` `" --> "` `+ me.map.toString());`

This results in this very strange result.

Map --> {}

Here I use reflection to modify the expected result.

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 * Copyright 2011 Bluelotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example;
 
import java.lang.reflect.Field;
import java.util.logging.Level;
import java.util.logging.Logger;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public final class Mod {
 
    public static final String MAP = "Map";
 
    static {
        try {
            Field[] fx = App.class.newInstance().getClass().getDeclaredFields();
            Field f = fx[0];
            f.setAccessible(true);
            MapValueHolder<String, String> mvh = new MapValueHolderImpl<String, String>();
            f.set(null, mvh);
        } catch (Throwable ex) {
            Logger.getLogger(Mod.class.getName()).log(Level.SEVERE, null, ex);
        }
    }
}

If you have followed me to this point, you will have learned a little bit about the Java Type system, reflection, abstraction, and Collections. Yet, you may be asking what is the tip? Here are some rules:

Use the keys to fetch values.
Check for null values. In my examples, I did not check for null values.
Use the correct Java Collection.

The Java Collection Framework covers most common cases. Take the time to read about them. The code above was based on a couple of issues I discovered: (1) Using keys for values, and (2) not using the correct collection. In this case, they should have used a List<V>. If they wanted to use an ordered Map<K,V>, they should have used a LinkedHashmap<K,V>.

The code for the examples are here: bad-mapping.implementation.zip

The code was developed using NetBeans 7.1 RC1.

Saturday, October 29, 2011

RESTful Web Services: Jerseylicious... a Jersey based client

I thought that I would provide a simpler example than the RESTful Web Services book. In this example I am using Jersey (JAX-RS Reference Implementation) client to do the same thing as Apache HTTP Client.

You can download the Apache Maven NetBeans project here: jerseylicious.zip

JerseyliciousApp.java

/*
 * Copyright 2011 Blue Lotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/*
 * $Id:$
 */
package com.bluelotussoftware.jerseylicious;
 
import com.sun.jersey.api.client.Client;
import com.sun.jersey.api.client.WebResource;
import com.sun.jersey.api.client.config.ClientConfig;
import com.sun.jersey.api.client.config.DefaultClientConfig;
import com.sun.jersey.api.client.filter.HTTPBasicAuthFilter;
import java.net.URI;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.UriBuilder;
 
/**
 * Example Jersey Application to read delicious bookmarks.
 * @author John Yeary
 * @version 1.0
 */
public class JerseyliciousApp {
 
    public static void main(String[] args) {
 
        if (args.length < 2) {
            System.out.println("Usage: JerseyliciousApp [username] [password]");
            return;
        }
 
        ClientConfig config = new DefaultClientConfig();
        Client client = Client.create(config);
        client.addFilter(new HTTPBasicAuthFilter(args[0], args[1]));
        WebResource service = client.resource(getBaseURI());
 
        System.out.println(service.path("v1").path("posts").path("recent").accept(
                MediaType.TEXT_XML).get(String.class));
 
    }
 
    private static URI getBaseURI() {
        return UriBuilder.fromUri("https://api.del.icio.us").build();
    }
}

RESTful Web Services: DeliciousHttpClient Example

I have been working on designing a replacement architecture for an enterprise application at work. As a result, I have been doing a lot of work with REST. The seminal work on REST is RESTful Web Services by Leonard Richardson and Sam Ruby from O'Reilly & Associates. The book is a couple of years old, but relevant today. There is only one issue with the book. There are a number of examples that do not work as expected in the current framework editions.

One such example is using Apache Commons HTTP Client. This particular framework is deprecated, and has been replaced by Apache HTTP Components.

The example code below demonstrates how to perform a RESTful call to del.ic.io.us to retrieve saved bookmarks. This is based on the application listed on page 35 of the book.

The Apache Maven based project can be downloaded here: delicious.zip.

DeliciousHttpClient.java

package com.bluelotussoftware.delicious;
 
// DeliciousHttpClient.java 
import java.io.IOException;
import java.io.InputStream;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.xpath.XPath;
import javax.xml.xpath.XPathConstants;
import javax.xml.xpath.XPathExpressionException;
import javax.xml.xpath.XPathFactory;
import org.apache.http.HttpException;
import org.apache.http.HttpResponse;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.Credentials;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.w3c.dom.Document;
import org.w3c.dom.NamedNodeMap;
import org.w3c.dom.NodeList;
import org.xml.sax.SAXException;
 
/**
 * <p>
A command-line application that fetches bookmarks from del.icio.us * and prints them to standard output.</p>
* <p>
This application is based on the work done by Leonard Richardson and Sam Ruby in the O'Reilly & Associates
 * RESTful Web Services Book.</p>
* 
 * @author Leonard Richardson
 * @author Sam Ruby
 * @author John Yeary
 * @version 2.0
 */
public class DeliciousHttpClient {
 
    public static void main(String[] args)
            throws HttpException, IOException, ParserConfigurationException,
            SAXException, XPathExpressionException {
        if (args.length != 2) {
            System.out.println("Usage: java -classpath [CLASSPATH] "
                    + "DeliciousHttpClient [USERNAME] [PASSWORD]");
            System.out.println("[CLASSPATH] - Must contain commons-codec, " + "commons-logging, and commons-httpclient");
            System.out.println("[USERNAME] - Your del.icio.us username");
            System.out.println("[PASSWORD] - Your del.icio.us password");
            System.out.println();
            System.exit(-1);
        }
 
        HttpClient client = new DefaultHttpClient();
 
        // Set the authentication credentials.
        Credentials creds = new UsernamePasswordCredentials(args[0], args[1]);
        ((DefaultHttpClient) client).getCredentialsProvider().setCredentials(AuthScope.ANY, creds);
 
        // Make the HTTP request.
        String url = "https://api.del.icio.us/v1/posts/recent";
        HttpGet method = new HttpGet(url);
        HttpResponse response = client.execute(method);
        InputStream responseBody = response.getEntity().getContent();
 
        // Turn the response entity-body into an XML document. 
        DocumentBuilderFactory docBuilderFactory = DocumentBuilderFactory.newInstance();
        DocumentBuilder docBuilder = docBuilderFactory.newDocumentBuilder();
        Document doc = docBuilder.parse(responseBody);
 
        client.getConnectionManager().shutdown();
 
        /* 
         * Hit the XML document with an XPath expression to get the list 
         * of bookmarks.
         */
        XPath xpath = XPathFactory.newInstance().newXPath();
        NodeList bookmarks = (NodeList) xpath.evaluate("/posts/post", doc, XPathConstants.NODESET);
 
        // Iterate over the bookmarks and print out each one. 
        for (int i = 0; i < bookmarks.getLength(); i++) {
            NamedNodeMap bookmark = bookmarks.item(i).getAttributes();
            String description = bookmark.getNamedItem("description").getNodeValue();
            String uri = bookmark.getNamedItem("href").getNodeValue();
            System.out.println(description + ": " + uri);
        }
        System.exit(0);
    }
}

Wednesday, October 26, 2011

Creating NetBeans Project with Existing Source Code

This is the second video in the series on how to simplify your coding with NetBeans. In this video I demonstrate how to import code from the Apache Commons CLI project into NetBeans. The source code IS NOT in a native format that NetBeans understands like Apache Maven. The files are imported into a NetBeans project with existing sources.

As with most code that you download, there are some dependencies which are unsatisfied. I demonstrate how to download the dependencies, and put the jar files into the project. Finally, I successfully build it.

Thursday, October 20, 2011

Creating a NetBeans Project from the Web

I created a simple demonstration of how to use NetBeans to open an Apache Commons CLI project directly from the Internet and build it along with the Javadocs.

This is the first of two video examples demonstrating the power of NetBeans to be more productive immediately.

SerialVersionUID Generator for NetBeans 7.0.1

Michal Hlaváč's SerialVersionUID Generator For NetBeans has been updated for use in NetBeans 7.0.1. If you have a need to generate SerialVersionUIDs for your Serializable classes. This is the plugin for you. You can download it from here.

http://kenai.com/projects/nb-svuid-generator/downloads/directory/nbms/nb7.0.1

Thursday, October 13, 2011

JDK7: String in Switch Example

switch in Java was always considered not particularly useful prior to Java 5. In Java 5, enum was added to the language. This made it more useful to use switch statements, but was still incomplete. A feature request that has been long in waiting is the ability to use a String in a switch.

Finally, in Java 7 SE we get the ability to use a String in a switch statement. This feature, I believe, will make the use of switch more prevalent in code which is post JDK 6.

The example below was developed using NetBeans 7.1 Beta on Oracle Solaris Express 11. The NetBeans Java project is located here: StringSwitch.zip.

This code was presented at the Greenville Java Users Group. The Unicode has a hidden message which is displayed when run.

StringSwitch.java

/*
 * Copyright 2011 Blue Lotus Software, LLC.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.bluelotussoftware.example.jdk7;
 
/**
 * <p>
* This is an example application that demonstrates the new JDK 7 feature for
 * Strings in switch statements. You need to run it to decipher the unicode
 * value.
 * </p>
*
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class StringSwitch {
 
    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
 
        String[] values = {"people", "tuna", "orange", "goldfish", "rabid hampster", "the device", "JDK7"};
        StringBuilder sb = new StringBuilder();
 
        for (String s : values) {
 
            switch (s) {
                case "goldfish": {
                    sb.append("\u0055\u0073\u0065\u0072\u0073\u0020");
                    break;
                }
                case "the device": {
                    sb.append("\u0069\u0073\u0020");
                    break;
                }
                case "tuna": {
                    sb.append("\u0047\u0072\u0065\u0065\u006e\u0076\u0069\u006c\u006c\u0065\u0020");
                    break;
                }
                case "rabid hampster": {
                    sb.append("\u0047\u0072\u006f\u0075\u0070\u0020");
                    break;
                }
                case "people": {
                    sb.append("\u0054\u0068\u0065\u0020");
                    break;
                }
                case "orange": {
                    sb.append("\u004a\u0061\u0076\u0061\u0020");
                    break;
                }
                default: {
                    sb.append("Awesome!");
                    break;
                }
            }
        }
        System.out.println(sb.toString());
        System.out.println("Thanks for attending this evening.");
    }
}

Wednesday, October 12, 2011

Try...Catch...Finally Puzzle Part II

In the first version, I think that the people missed the interesting stuff. So here is a modified version, of the code. Remember, the real question is what to expect. It will compile, and run. The two examples are more interesting.

NOTE: This is not an example of how to do something right. This is absolutely the wrong way to handle exception handling in Java.

Main.java

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example.se;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.1
 */
public class Main {
 
    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        try {
            throw new NullPointerException("NullPointerException 1");
        } catch (NullPointerException e) {
            throw new NullPointerException("NullPointerException 2");
        } finally {
          return;
        }
    }
}

Main2.java

/*
 * Copyright 2011 John Yeary<jyeary@bluelotussoftware.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.bluelotussoftware.example.se;
 
/**
 *
 * @author John Yeary<jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class Main2 {
 
    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        try {
            throw new NullPointerException("NullPointerException 1");
        } finally {
            return;
        }
    }
}

Here is the NetBeans project for the code: FinallyReturn2.zip

Tuesday, October 11, 2011

Try...Catch...Finally Puzzle

I showed a similar example at my last GreenJUG meeting. In the example code below, I have a try{...}catch(Exception e) {...}finally{...} puzzle.

Before running the code ask yourself three questions: does it compile, does it run, and what is the result?

Tell me what the expected result is supposed to be and why?

Main.java

/*
 * Copyright 2011 John Yeary <jyeary@bluelotussoftware.com>.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.bluelotussoftware.example.se;
 
/**
 *
 * @author John Yeary <jyeary@bluelotussoftware.com>
 * @version 1.0
 */
public class Main {
 
    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        try {
            throw new NullPointerException("NullPointerException 1");
        } catch (NullPointerException e) {
            throw new NullPointerException("NullPointerException 2");
        } finally {
            System.out.println("Do I ever get printed?");
            return;
        }
    }
}

The example code is a NetBeans project and can be downloaded here: FinallyReturn.zip

The Java Life

When Oracle contacted me about doing a survey for them to use at JavaOne 2011 I had no idea what they had planned. As a result I sent back my survey with a bunch of fun loving answers. Some of them serious, but most were simply funny answers. I guess a couple of the other JUG Leaders had the same idea.

The result was a video which was a video called "The Java Life" which aired at the opening JavaOne and JavaOne Community keynote addresses. I have attached the video for your enjoyment. The lyrics are below it, and finally you can see my survey responses.

Who said Oracle doesn't listen?

Future Perfect / l.inc design
9.1.11

SPOKEN:
In the cubicles representin’ for my JAVA homies…
In by nine, out when the deadlines are met, check it.

CHORUS:
We code hard in these cubicles
My style’s nerd-chic, I’m a programmin’ freak
We code hard in these cubicles
Only two hours to your deadline? Don’t sweat my technique.

Sippin’ morning coffee with that JAVA swirl.
Born to code; my first words were “Hello World”
Since 95, been JAVA codin’ stayin’ proud
Started on floppy disks, now we take it to the cloud.

On my desktop, JAVA’s what’s bobbin’ and weavin’
We got another winning app before I get to OddEven.
Blazin’ code like a forest fire, climbin’ a tree
Setting standards like I Triple E….

Boot it on up, I use the force like Luke,
Got so much love for my homeboy Duke.
GNU Public Licensed, it’s open source,
Stop by my desk when you need a crash course

Written once and my script runs anywhere,
Straight thuggin’, mean muggin’ in my Aeron chair.
All the best lines of code, you know I wrote ‘em
I’ll run you out of town on your dial-up modem.

CHORUS:
‘Cause…
We code hard in these cubicles
Me and my crew code hyphy hardcore
We code hard in these cubicles
It’s been more than 10 years since I’ve seen the 404.

Inheriting a project can make me go beeee-serk
Ain’t got four hours to transfer their Framework.
The cleaners killed the lights, Man, that ain’t nice,
Gonna knock this program out, just like Kimbo Slice

I program all night, just like a champ,
Look alive under this IKEA lamp.
I code HARDER in the midnight hour,
E7 on the vending machine fuels my power.

Ps3 to Smartphones, our code use never ends,
JAVA’s there when I beat you in “Words with Friends”.
My developing skills are so fresh please discuss,
You better step your game up on that C++.

We know better than to use Dot N-E-T,
Even Dan Brown can’t code as hard as me.
You know JAVA’s gettin’ bigger, that’s a promise not a threat,
Let me code it on your brain

WHISPERED:
so you’ll never forget.

CHORUS:
We code hard in these cubicles,
it’s the core component…of what we implement.
We code hard in these cubicles,
Straight to your JAVA Runtime Environment.

We code hard in these cubicles,
Keep the syntax light and the algorithm tight.
We code hard in these cubicles,
Gotta use JAVA if it’s gonna run right.

We code hard in these cubicles
JAVA keeps adapting, you know it’s built to last.
We code hard in these cubicles,
Robust and secure, so our swag’s on blast

CODE HARD

Here is my original survey...

Here are some answers for you to your questions. It was fun. I hope you enjoy the answers.

What is your favorite Java enabled device?
A: SunSpot

Have you ever used Java in an unconventional way?
A: Named my cat 'Java', tried to teach my 5 year old to program with it, and poured it in a beer to make sure I did not waste it.

Have you ever heard of Java being used in an unconventional way?
A: Yes, ask Adam Bien about his thermostat.

What would you say is the best use for Java?
A: Besides drinking it, it is also really good for removing rust, and creating great MVC Model 2 design n-tier enterprise applications.

What project that you've worked on are you most proud of?
A: A good question. I think that the Java boot camp project on Java.net is a great project. I like to teach others to program. Oh, and my boss says everything that I am currently working on!

Is there something universally frustrating about being a programmer?
A: Yes, computers won't bend to my mind control. Most programmers know what they want their applications to do. The implementation is the difficult part. I am only partly kidding about the mind control!

If Java had an enemy, what/whom do you think it would be?
A: Actually my cat Java has a nemesis called 'chipper' the chipmunk who taunts him from outside the bay windows. Duke the champion of all that is good fears only TEN. TEN. TEN. (.NET backwards).

What is the worst thing to hear about a project as a Java programmer?
A: ... and can you have that done by 5:00 PM?

Describe your Ideal Day
A: I wake up and go sailing. The wind is perfect and I beat Larry in a race with a Sunfish. He is so impressed, he donates his BMW-Oracle race boat to my Alma Mater Maine Maritime Academy, and asks for remedial sailing lessons. Oh, and I get all of my coding projects done... before 5 PM. ;-)

What is your favorite snack?
A: Beer

What is your favorite beverage?
A: Guinness... or as noted above with Java.

Do you have any hobbies?
A: Dreaming! Java programming, Sailing, Hiking, Kayaking, Rafting, Canoeing, Camping, Biking, Yoga, Paper Airplanes, Model Airplanes, Linux, Shooting, Fire Fighting, and just about anything that could get you killed in a horrific fantastic epic manner.

What are your favorite video games?
A: Fallout 3, and Fallout New Vegas.

What/Which gaming system(s) do you use?
A: PS3 and Nintendo Wii

Do you hang out with other Java programmers?
A: Yes, they are great people. Common interests, and common bonds make great friends.

What do you do together when you hang out?
A: DRINK BEER! We have intellectually stimulating conversations about which algorithms are best suited to solve complex coding challenges. Who am I kidding, WE DRINK BEER and discuss everything from the cute waitress to particle physics (yes very geeky).

Tell me a funny story that happened while on the job?
A: Don't drink and team code. Let's just say it can be...interesting. We were working over a weekend on a project and came across a corner case on the project. The software was for use by field service engineers working remotely. The case was to submit a service ticket it had to have a) time, b)parts, c) both, and d) (CORNER CASE) an attempt to submit a ticket with nothing. I commented that only a "moron" would do that. My partner agreed, and I thought it would be funny to place a pop-up in the code called a "Moron Alert". We ran it, drank more, ran it some more, and laughed at my cleverness... one problem. Yup, you guessed it. Anyway, the application gets deployed and has been running for 3 years until someone (a moron) gets the alert. His manager calls me crying from laughing so hard. He had asked the engineer what he did to get "MORON ALERT...MORON ALERT...MORON ALERT. What are you a moron for trying to submit a ticket without parts, or time. Are you a moron (Yes/No). Only the yes button works. Funny!

What websites or blogs do you visit most often?
A: My own (http://javaevangelist.blogspot.com). I can't seem to remember my own solutions to problems until I Google it, and discover I covered it in my own blog. Arun Gupta (http://blogs.oracle.com/arungupta/), and Java.net.

What are your favorite TV shows?
A: All things sports especially baseball, and college football.

What are your favorite movies?
A: Metropolis, Blade Runner, and Apocalypse Now.

Who is your favorite band, or recording artist?
A: Front Line Assembly.

Who are your favorite comedians?
A: Sarah Palin, Nancy Bachman, and the crew of Saturday Night Live.

What are your favorite viral videos?
Flu Attack! How A Virus Invades Your Body

Outside of work, how much time do you spend on a computer?
A: According to my wife, far too much time. I have a computer on my nightstand, and I have fallen asleep with my hands on the keyboard. Thankfully I don't drool.

What are some stereotypes of Java programmers? How accurate are they?
A: What someone is stereotyping us! I want to be monotyped! People should hear a single voice. Java programmers are supposedly introverted, and lack social skills. They are not accurate... I am an extrovert.

Are there common characteristics of Java programmers who do not fit the stereotype(s)?
A: Bruno Souza, Martijn Verburg, Stephan Janssen, and of course me. All of them are friendly, honest, approachable, and kind. They are willing to help others if you simply ask, and love to code.

Are there any inside/industry jokes in the Java world?
A: Have you seen the videos that JavaZone puts out. http://jz11.java.no/trailer_video.html

What do you love about Java itself, or love about being a Java programmer?
A: Java has a promise to "write once...run anywhere." This is a powerful tenet of the language. This power allows you to be creative in ways that only are limited by your imagination. In 1995, people had a vision about what could be possible, but if you asked them today whether it would power Predator Drones, or control the Large Hadron Collider (LHC); the answer would have been no. If you asked them today if they are surprised; the answer would be no. I like being able to dream, and to teach my kids to dream. There fantasies are our future, one hopefully powered by Java.

If you weren't a Java Programmer, what might be your focus/passion?
A: I love the ocean, and I would likely go back to being a Merchant Mariner. I love to sail, and I am passionate about preserving the oceans. Perhaps I would work on engineering more efficient sailing methods for merchant vessels to reduce the reliance on fossil fuels.

Subscribe to: Posts ( Atom )

Pages

Saturday, December 31, 2011

Technical Details

CustomerFacadeREST.java

CODE

JSONJAXBContextResolver.java

Friday, December 30, 2011

Wednesday, December 28, 2011

MultiContentServlet.java

Sunday, December 18, 2011

Friday, December 16, 2011

Thursday, December 15, 2011

Wednesday, December 14, 2011

Process

Conclusion

Tuesday, December 13, 2011

Requirements:

Procedures

Configure GlassFish

NetBeans

Verification

Conclusion

Friday, December 02, 2011

MapEntryType<K, V>

MapType<K, V>

XmlGenericMapAdapter<K, V> extends XmlAdapter<MapType<K, V>, Map<K, V>>

Saturday, October 29, 2011

JerseyliciousApp.java

DeliciousHttpClient.java

Wednesday, October 26, 2011

Thursday, October 20, 2011

Thursday, October 13, 2011

StringSwitch.java

Wednesday, October 12, 2011

Main.java

Main2.java

Tuesday, October 11, 2011

Main.java

Popular Posts

Search

Pageviews

Blog Archive

Labels

Subscribe Now

Subscribe via email

Copyright Notice