Jazoon'08 Fish Menu: Glassfish and Web-Services

Nowadays I am focused in web-services, specially SOAP web services and Glassfish/Metro technologies, so let's check the Jazoon'08 fish menu:

Since it was created, the cejug-classifieds project served as a proof of concept for a lot of technologies. Now it comes back with a new set of SOA technologies.

I plan to post our detailed plans asap, but until I find time to create better documents, I published a collaboration diagram in the cejug-classifieds home page and I also published a WAR file you can run in Glassfish for testing - the deployment descriptor included in the WAR is only ready for Glassfish, and I am looking for a volunteer to adapt it to Tomcat or JBoss :). If you prefer to inspect the code snapshot, you can checkout the complete source code from SVN.

Take the subway and visit us at the Cejug-Classifieds, we are waiting for your best tips about our new plans.

text=word
primitive=2
anobj.name=test
anobj.integer=3

// Read properties file.
Properties properties = new Properties();
properties.load(new FileInputStream("filename.properties"));

// Unmarshal the properties XML file into a Java Object
JAXBContext jc = JAXBContext.newInstance(
		AbstractJaxbFootprintStream.FOOTPRINT_CONTEXT, this.getClass()
				.getClassLoader());

Unmarshaller unmarshaller = jc.createUnmarshaller();
unmarshaller.setEventHandler(new FootprintConfigValidationHandler());
unmarshaller.setListener(listener);
SchemaFactory sf = SchemaFactory
		.newInstance(javax.xml.XMLConstants.W3C_XML_SCHEMA_NS_URI);
Schema schema = sf.newSchema(getClass().getClassLoader().getResource(
		"config.xsd"));
unmarshaller.setSchema(schema);

MyConfig properties = (JAXBElement) unmarshaller
		.unmarshal(new FileInputStream("filename.xml")).getValue();

// A String:
String text = properties.getProperties("text");

// Other primitive values:
int number = Integer.parseInt(properties.getProperties("primitive"));

// An object:
String name = properties.getProperties("anobject.name");
int integer = properties.getProperties("anobject.integer");
Object yourObj = new YourObj(name, integer);

// A String: 
String text = properties.getText();

// Other primitive values:
int number = properties.getPrimitive();

// An object: 
Object yourObj = properties.getMyObject();

• The red text are hard-codes occurrences. Even if you create constants, you continue with the issue to remembers its names, and if you commit a typo or other minor mistake, nor the IDE neither the compiler will help you to avoid problems under production.
  
• Other issue is about creating complex types: you are responsible for converting the key/values pairs in Java Objects in case of complex types. You need to check if the attributes required for creating the object are present and also its types and/or if the value associated to the key is not null.
• Property files cannot be checked against its syntax or contents, since it is just a plain text file.
• Complex types should be simulated by a set of key/value pairs and later converted in a non-bullet-proof code.
• If the application requires different set of properties, it should rely on several different files. These files are independent and you must create a custom code to manage it in your application.

• No hard-codes, you don't need to check which string map to a certain object.
• No types conversion by code - the methods you use to retrieve the values from the Configuration Object are defined with the correct type.
• There is no risk of deploying typos or minor mistakes since the compiler and the IDE will notify your mstakes on the fly.
• XML Property files can be verified against its Schema definition.
• Support for complex types.
• Different set of properties can be modeled in a unique file, using nested elements. Even if you need to use different XML properties files, you can import files in a master definition, creating a formal relationship between them.