Page Comparison

Table of Contents
minLevel 3

...

• Open Preferences
• Navigate to the Workspace preferences: General → Workspace
• Change the Text File Encoding to UTF-8
• Change the New Text File Line Delimiter to Other and select Unix from the drop-down

Troubleshooting

• Remove all of your PLFM projects, check out a fresh copy of the PLFM project and start from the beginning of this document.
• Performing a Maven update.
• Alternatively, you can just Check your exclusion filters through configure build path in Eclipse to assure nothing is excluded, then refresh and clean the SWC project.
• "Could not deserialize" or similar problems in Super Dev Mode are most often fixed by re-building through the command line (running 'mvn clean install')
• (git) Pull the latest changes from the upstream repository.
• Try to rebuild your Eclipse's Portal project and keep your files in place:Git pull update to the newest version.
• Perform a Maven update.  

1. Delete your project from Eclipse (leave "Delete project contents on disk" UNCHECKED)
2. Go to the project root on your file system and delete .classpath, .project and the .settings/ folder
3. Go to Step 7 6 in "UI Development above"

...

1. Use the '-clean' argument.
   1. One way to do this is to add -clean on its own line as the first line on the eclipse.ini file, and restart Eclipse.
2. Use a new workspace.
   1. I followed the instructions in the site linked above. The gist of it is:
      1. Export your preferences to somewhere outside your Eclipse environment environment (Export → General → Preferences. Make sure that 'Export All' is checked.)
      2. Switch to a new workspace. (Switch Workspace → Other, then name your new workspace.)
      3. Import your preferences into this new workspace (Import → General → Preferences, make sure 'Import All' is checked.)
      4. Import trunk as usual.

Common Problems

...

Technologies used

There are several technologies that we are currently utilizing in the portal. The following is a list of primers for each:

• For dependency injection, a an example of Inversion of Control (IoC), we are using a combination of GIN and Guice.
  • Guice - is the base IoC technology but it is only fully functional in Server-side. http://code.google.com/docreader/#p=google-guice&s=google-guice&t=Motivation
  • Gin - provides basic IoC for GWT client-side code. http://code.google.com/p/google-gin/wiki/GinTutorial
  • Guice Servlet - This is a sub-project of Guice that allows dependency inject into Servelets. http://code.google.com/p/google-guice/wiki/ServletModule
• Http REST calls are currently made using Spring's RestTemplate. http://blog.springsource.com/2009/03/27/rest-in-spring-3-resttemplate/
• To create API REST stub-services we are using a combination of two technologies:
  • Jersey - provides a quick and easy method for transforming simple POJO's into RESTful web services using annotations. http://jersey.java.net/nonav/documentation/latest/user-guide.html
  • Grizzly - The GrizzlyWebContainerFactory makes it simple to start a local web container. http://blog.msbbc.co.uk/2008/11/java-using-jersey-and-grizzly-to-create.html
• Mockito testing framework - mock dependent classes/interfaces to isolate test.  Verify expected interactions (including async calls).  http://site.mockito.org/
• Bootstrap UI framework (including a number of extras widgets), wrapped for GWT.  https://gwtbootstrap3.github.io/gwtbootstrap3-demo/
• Markdown-it  for markdown processing.  https://github.com/markdown-it/markdown-it .  Extended the library by adding a number of plugins, available on npm.  The Node.js plugin that's used to orchestrate the processing is called markdown-it-synapse

Cross-browser testing

We have a shared account to use BrowserStack to test the website for cross browser compatibility issues.
Alternatively, for testing IE on Mac I use VirtualBox with an image provided by Microsoft from modern.IE.  For this to work, in your Windows VM, you will need to map an ip to outer in order to access your local machine (note, Windows UAC requires you to do this as an admin).

...