Mr N

This blog is an addendum to Configuring Eclipse to use Tomcat and the Spring Framework but is solely related to Spring IDE 2.2.

1. Install Eclipse 3.4.1 JEE Ganymede SR1
2. Load Eclipse and goto Help->Software Updates…
3. Select the Available Software tab and click Add Site
4. In the Location enter http://dist.springframework.org/release/IDE then click Ok
5. After a bit of flickering Spring IDE Update Site appears (twice!) and along with a couple of others sites
6. If you right click on “http://download.eclipse.org/tools/mylyn/update/e3.4″, select Properties, Click Ok, then check and uncheck Include items that have already been installed then the “http://download.eclipse.org/tools/mylyn/update/e3.4″ site will change to Mylyn for Eclipse 3.4!
7. Check Mylyn for Eclipse 3.4, one of the Spring IDE Update Site and http://download.eclipse.org/tools/ajdt/33/update/, click Install… - If the Install button is not enabled then uncheck and re-check the buttons until they are select and Install is enabled!
8. You be taken to the Install screen, showing the size of the update as (40,518KB) and All details are ok. Click Next.
9. Now you have to agree the Licenses, so check I accept the terms of the license agreement and click Finish.
10. The software updater will start downloading and installing the updates. You can click the Details button to see what is going on.
11. You must then restart the workbench

I use M$ Excel to help with project time-sheeting and billing. My bills are really simple and contain project id, project title and time spent in hours and minutes (h:mm). The project id and project title can be looked up on the issue tracker and filtered on the dates so there is no need to include all that lengthy information in the invoice. This produces a table of results. I have been trying to sum the time’s column, but each time it rolled over 24 hours it reset the clock and loss the information. For example 23:00 + 2:00 became 1:00 instead of 25:00. I had to count it up by hand, it was a good job I had to do all that time maths for my 11+! I had a bit of a hunt and found the solution on the Micro$oft knowledge base. Just do the summation as normal but format the cells to be in the format [h]:mm and the “h” part will handle the overflow. Simple in the end!

Been having a look at OpenID. It seems like a really good idea. I have loads of user names and passwords to all the support sites on the internet. You try and pick the same one on each but occasionally there is another joebloggs out there who steals your user name so you have to select another like joebloggs2. And because that web site has a different policy for their password security your usual 8-letter password is now not enough because they want at least 10 with some punctuation. So you have all these user names and all these passwords and the only thing you can do to remember them is write them all down on a post-it and stick it to your monitor! Not very secure! OpenID tries to address the problem of decentralised authentication. It is trying to create a single sign-on for the internet. Being a Paranoid Penguin, I don’t want to entrust a corporate giant, with access to all my other accounts, so I had a hunt for an OpenID implementation that I could set up on my own server. I discovered phpMyID. phpMyID is a single user OpenID server. The package consists of just 2 PHP files!. It doesn’t need access to a database or anything really! It’s just the 2 files! There is a README file with some easy to follow instructions but I’ll outline the salient points and the problems I had.

1. It goes without saying that you make sure that your web server has PHP running in your domain!
2. Go to a convenient place under your document root and create a folder to put your configuration files.
3. Create a directory for the installation: $root/openid, where $root is your document root.
4. Go into it and download the program body:

   wget https://www.siege.org/svn/oss/phpMyID/trunk/MyID.php

5. Now create a folder for each user:

   mkdir mrn

6. Go into each folder and download the configuration file:

   wget https://www.siege.org/svn/oss/phpMyID/trunk/MyID.config.php

7. Next configure each user.
8. Load the configuration file (MyID.config.php) into your favourite text editor and change the last line from

   require(’MyID.php’);

   to

   require(’../MyID.php’);

9. In your web browser goto http://www.example.co.uk/openid/mrn/MyID.config.php and make a note of the Realm
10. Now we have to create our user name and password. On the command line enter:

    echo -n ‘username:realm:password’ | openssl md5

    where username is your username, realm is the Realm you made a note of earlier and password is your password. This gives you an MD5 hashed encoded string.
11. Edit the user’s MyID.config.php and change the auth_username to the user name you have just invented and the auth_password to the hashed password you have just created.
12. Now we must test our login mechanism. From your web browser goto:

    http://www.bigsoft.co.uk/openid/mrn/MyID.config.php

    and click Login.
13. Under Plesk I get the message

    Missing expected authorization header.

    so I need to configure the web server to allow the PHP variable PHP_AUTH_DIGEST to be set by the web server.
14. Download the example htaccess file from the phpMyID site and place it in $root/openid/mrn/.htaccess.
15. Edit the .htacess file and uncomment option 3 (mod_setenvif)
16. Finally we need to set up a url location that tells the OpenID mechanism where the openid.server and openid.delegate are.
17. In our user’s directory $root/openid/mrn create a file called index.html and fill it with the following:

    
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    <html xmlns="http://www.w3.org/1999/xhtml"  xml:lang="en">
    <head>
        <link rel="openid.server" href="http://www.bigsoft.co.uk/openid/mrn/MyID.config.php"/>
        <link rel="openid.delegate" href="http://www.bigsoft.co.uk/openid/mrn/MyID.config.php"/>
    </head>
    <body>
    Nothing to see here, move along.
    </body>
    </html>
    

18. Now go to the web site that supports OpenID and login with the url

    http://www.bigsoft.co.uk/openid/mrn/

19. You will be presented with a login from your server asking you to login. Enter the username and password that you used in step 10 and away you go.

In order to avoid full file-system paths in a Tomcat configuration, you make all the file references point to elements on the classpath. The classpath is an environment variable which is set outside of Tomcat, and is the search path that the class loader uses in order to find classes. When importing another bean definition file you would be far better off using something along the lines of the following, instead of a file:/path/to/file

<import resource="classpath:uk/co/bigsoft/beans.xml"/>

Under Eclipse (3.4 Ganymede (but I’m sure this applies to all versions of Eclipse)) you can link projects together and create project dependencies. Creating a dependency means that when you open a project, it will open the projects it depends on. Also, when you run the project it incorporates the classpath of the dependant projects into its own classpath. If you do this and run Tomcat you will get an error similar to:

class org.springframework.web.context.ContextLoaderListener org.springframework.beans.factory.parsing.BeanDefinitionParsingException: Configuration problem: Failed to import bean definitions from URL location [classpath:uk/co/bigsoft/proj/dino.live.xml] Offending resource: ServletContext resource [/WEB-INF/sitemanager-webapp-config.xml]; nested exception is org.springframework.beans.factory.BeanDefinitionStoreException: IOException parsing XML document from class path resource [uk/co/bigsoft/proj/dino.live.xml]; nested exception is java.io.FileNotFoundException: class path resource [uk/co/bigsoft/proj/dino.live.xml] cannot be opened because it does not exist

This problem occurs because Tomcat is running as a separate application with its own environment - an environment that does not include classpath links to your other Eclipse projects (even though you have linked them together in Eclipse). There follows a step-by-step guide to adding multiple Eclipse projects to Tomcat classpath. This follows on from the Configuring Eclipse to use Tomcat and the Spring Framework article I wrote earlier.

1. After attaching the project to the Tomcat server, double click the Tomcat v6.0 Server at localhost to popup the Tomcat server configuration window.
2. Click General Information->Open launch configuration
3. Select Classpath tab
4. Highlight User Entries (buttons will become enabled)
5. Click Add projects… button
6. Check the boxes of the projects you want to include.
7. Click ok….ok….etc

Been trying to get rid of this error message in my Spring container for a while and I have finally built up enough periphery knowledge to figure out the solution myself, so I thought I’d share it with you - I’m nice like that! The offending message in Eclipse is:

cvc-id.1: There is no ID/IDREF binding for IDREF ‘transactionManager’

After a search I found: http://documentation.softwareag.com/crossvision/ins441/messages/imsg.htm Which provided the very helpful advice:

The document contains an IDREF value which does not exist as an ID value. Modify your document.

In my example it was moaning about the transactionManager but in your case it could be anything. Inside my containers xml configuration I had a bean which uses a reference to a local bean called transactionManager. Local here is the important bit. Local means that it is defined within the scope of this document - not in a linked or imported document, but in this one. In my case it was defined like this:

<bean id="mybeanid" class="uk.co.bigsoft.proj">
  <property name="transactionManager">
    <ref local="transactionManager"/>
  </property>
</bean>

In order to fix the problem, I changed the transactionManager bean reference to not be local:

<bean id="mybeanid" class="uk.co.bigsoft.proj">
  <property
    name="transactionManager"
    ref="transactionManager"/>
</bean>

And the problem went away!