Eclipse Fever

EMF @ Eclipse India Summit '09

2009-07-18T21:08:00.000-07:00

I had the oppurtunity to speak at the Eclipse India Summit 2009. It was a joint session with me and my friend and ex-colleague Annamalai ... so we thought we'll do something different with the session ... which was for 3 hours!!! Yes the audience had to bear with us for 3 hours. We, instead of dividing the presentation content amongst ourselves wanted to be different - both of us were on stage and delivering the presentation like a dialogue. It was like Malai represented the new user or developer who's new task is to learn and do something out of EMF and i played the supposed know-something-about-EMF guy who went around answering his questions.

The session started off soon after a great lunch ... in an hall with real cozy ambience. The MC actually had to ask the ppl to stand up and had them stretching to make them alert. Then the session started off ... i was kinda petrified initialy looking at all those people eagerly waiting to take something out from the session ... the show went on frequently switching from the slides to showing running examples. We started off to a packed audience ... and finished to a packed audience. In the end both me and Malai were exhausted from all the talking and standing, but it felt good. Content and video of the slides will be uploaded soon (i m waiting with my fingers crossed.)

Help assistant widget for RCP

2009-05-04T06:15:00.000-07:00

Everyone who's used any MS office application would have come across this annoying yet sometimes useful Office assistant. He's there to "point" us in the right direction to do something. If we've got questions (as silly as how to wrap text) he may have the "answers".

I was wondering ... RCP has a very nice help system in the form of cheatsheets, balloon help, context based help, status bar messages, etc... which will prompt the user for action/attention as required. But the help system doesn't have something like a help assistant - similar to the ones in MS Office applications. Eclipse RCP as an application is used in a variety of domains (hell even Swiss Railway people use it!) we get users who aren't aware as much and aren't willing to experiment or search to find out. I'll share some inputs I got from users who don't know much the Eclipse UI way. There are a some of them who say "How do I know that i have to right-click on the wizard to get a context-menu full of options ?" We can provide a message in the wizard page ... but that may be hard to notice.

I feel RCP help assistant widget is a better HMI mechanism than the usual status bar messages. May be the widget can be a very low on graphics, animation and high on usefulness. This is just an idea ... I thought I'll share.

PgUp and PgDwn through Editors

2009-02-23T07:46:00.000-08:00

Today started off pretty good. My favorite music-director (composer) A R Rahman won the Best Original Score Oscar for the movie Slumdog Millionaire ... and i got a "Welcome to the Planet" mail from Planeteclipse.org

This motivated me to write something on this day ... just to keep a note. Being true to my blog's "tweakeclipse" self ... I want to tell you about a nice to have and lesser known (as far as i know) navigation feature in Eclipse Editors. You can use Ctrl + PgUp and Ctrl + PgDwn to move across the open editors! This is one more shortcut amongst many as listed in this blog entry by Nirav Thaker. One of my guru's says that this shortcut is inspired from MS Excel.

Hope this helps!

Create Maps in EMF - the other way

2009-02-16T07:28:00.000-08:00

EMF wiki on Eclipsepedia has a post which shows you one method of creating maps in EMF.
I feel that the suggested method in wiki will not exactly allow you to access a map as it should be.
like say - myMap.put("key", value); Instead you'll have to do:

myMap.eSet(keyFeature, "key");
myMap.eSet(valueFeature, valueObj);

After some trails here's the second method summarized in terms of steps.
To create a map using Reflective Ecore Editor:

create an EAttribute and set a name (let's say _map) to it.
set _map's EType as EMap [java.util.Map]
create an ETypedParameter for key and set EType accordingly
crate another ETypedParameter for value and set EType accordingly.

here is a snap shot of how a map looks in the Ecore Editor.

what happens behind the scenes of the editor ?
well, these lines of code are executed.

EAttribute _map = EcoreFactory.eINSTANCE.createEAttribute();
_map.setName("_map");
EGenericType _mapType = EcoreFactory.eINSTANCE.createEGenericType();
_mapType.setEClassifier(EcorePackage.eINSTANCE.getEMap());
// set key
EGenericType key = EcoreFactory.eINSTANCE.createEGenericType();
key.setEClassifier(EcorePackage.eINSTANCE.getEString());
// set key
EGenericType value = EcoreFactory.eINSTANCE.createEGenericType();
value.setEClassifier(EcorePackage.eINSTANCE.getEObject());
// add them
_mapType.getETypeArguments().add(key);
_mapType.getETypeArguments().add(value);
_map.setEGenericType(_mapType);

You have to use it like this:

Map _map = (Map) instance
.eGet(_mapFeature); // this is now java.util.Map
// don't forget to set the changes on _map back to instance!

Happy mapping!

Add branding to the XML files you generate from your EMF model

2009-02-10T21:45:00.000-08:00

What if you want to suggest that an XML file is generated using your product?
If you look at some of these commercial tools they add a comment which proudly says "used XXX v a.b.c to generate this file." Just out of curiosity I wanted to do the same using EMF resource save api.

Guess what! It is possible to do such a thing with EMF resource api. There's this interface called ResourceHandler inside org.eclipse.emf.ecore.xmi.XMLResource.java which can be implemented as required. I have provided an example for your benifit.

public class MyResourceHandler implements ResourceHandler {

/*
* you have the file handle of the XML!
*/
public void postSave(XMLResource resource, OutputStream outputStream,
Map options) {
// append your comment here.
byte[] trailcomment = "some comment"; // enclose it in XML comment tags.
try {
outputStream.write(trailComment);
}
catch (IOException e) {
// may be log something here.
}
// do NOT close the stream here. EMF resource save will eventually do it for you.
}
}

You can find the link to the EMF newsgroup thread here.

The Unbearable Stupidity of Modeling - a talk by Ed Merks

2009-01-05T22:53:00.000-08:00

"Unbearable stupidity of Modeling" is the name of a 50 minute long tech talk to be given by Ed Merks himself at EclipseCon 2009. Choosing such a title is a very good example of Reverse Engineering ... that is ... accept the mis-conception before disproving it! In this case it may be an attempt to clear out some of the so-called disadvantages or problems with using EMF.

I was just browsing around on some of the talks in the EclipseCon website and I found this. The heading of Ed's talk makes a bold statement, and so does almost all of the content in the abstract. If a guy who is using EMF in his projects/requirements reads through the abstract will be taken slightly aback by the tone except for one last line which changes the tone completely. Nice trick to make people read on ;)

I so want to listen to Ed speak about this topic ... given the different nature of the abstract itself the whole topic ... i think will be an eye opener for many of us. People who have an oppurtunity to attend EclipseCon ... don't miss this talk! You can find the abstract here.
Can't wait for the content of the talk to come out ... coz I cannot make it to EclipseCon (the reason is simply complicated ;)

Manage Extension Locations in Eclipse Ganymede

2008-10-19T07:27:00.000-07:00

An Eclipse developer is very quick to spot the very visible difference in the new Ganymede release. We are used to download an IDE and customize the configuration using the Help -> Software Updates -> Manage Configuration. Guess what! there is no more a Manage Configuration option anymore in Ganymede. Instead its called Software Updates for Installed Software and Available Software.

It looks kinda complicated at first, let's see how do u Manage Configuration in Eclipse Ganymede. This article gives a clear picture.

Save an EMF Resource with or without namespace!

2008-10-18T22:29:00.000-07:00

We tried out this one somewhere in 2007, but i suddenly felt the need to write about it now( i dono, funny like that!). Well coming to the point... serializing an EMF Resource to an XML file actually seems strange but sometimes it becomes necessary. I'll not get into the details of why do we need an XML file with no namespace! and just tell you how to do it.

When an XML file is parsed using Resource API, for every XML element a corresponding model element is searched from an EPackage instance. This EPacakge instance is normally registered to an namespace URI. For eg. <myns:SHIPORDER> XML element may map to an EClass ShipOrder in the model and myns URI is registered to an instance of ShipOrderPackage. So when the SHIPORDER XML element is encountered Resource API understands that an object of type StudentType is to be created.

Now, what if the XML element has no namespace... it'll look like this: . If we want to continue the usual way, then we have to do:

Register the EPackage instance to an empty namespace URI.
extend the XMLHelperImpl class and override getQName(EPackage, String, boolean) method
bind this XMLHelper implementation to your model's generated XyzResouceImpl through createXMLHelper() method.

The first point is quite straight forward. Although its better to register ur EPackage instance to both empty as well as the required namespace URI. For the second one, you need to extend the class org.eclipse.emf.ecore.xmi.impl.XMLHelperImpl and override the method specified above to suit ur requirements. Here's an example (considering the good old ShipOrder schema model)

/**

* let's save without namespace!

* just delegate to appropriate Resouce API

public class ShipOrderXMLHelper extends XMLHelperImpl {

protected String getQName(EPackage package1, String name,

boolean mustHavePrefix)

{

if( isNameSpaceNeeded() ) {

// let's send what ever prefix that's got as the arguement

return super.getQName(package1, name, true);

}

else {

// i don't want a namespace prefix

return super.getQName(package1, name, false);

}

return "";

}

Now that we have our implementation of XMLHelper, let's bind it to the generated ShipOrderResource implementation.

/**

* The Resource associated with the package.

* @see org.example.shiporder.util.ShiporderResourceFactoryImpl

* @generated

public class ShiporderResourceImpl extends XMLResourceImpl {

/* (non-Javadoc)

* @see org.eclipse.emf.ecore.xmi.impl.XMLResourceImpl#createXMLHelper()

* an override to bind our helper implementation

protected XMLHelper createXMLHelper() {

return new ShipOrderXMLHelper();

}

// other generated ShipOrderResouceImpl methods follow.

} //ShiporderResourceImpl

That's it you are all set to serialize an EMF resource without namespace. Before you go for a coffee ... one last thing ... do not forget to create ur EMF resource from the generated XyzResourceFactory.

Back To Basics!

2008-07-23T06:18:00.000-07:00

Some interesting articles about basics that an eclipse (or a Java) developer must know.

1. Let's start with the classpath itself!
> Here's an interesting article on IBM Developerworks by Elliot Harold. Good read this one.