Troubleshooting JSF Portlet Deployment Errors

Community Blogs 2014/07/15 投稿者 Cody Hoag Staff

Many of us have experienced it, you go to deploy a new application into your portal instance and see the dreaded deployment error messages. What do you do? Is the error message helpful? How can I find the solution?

If you're experiencing deployment problems with deploying a JSF portlet on Liferay, there's a simple process you can follow to solve your deployment issues. Instead of trying to figure out what's wrong with your code, it's sometimes easier to compare your portlet to a working example. The strategy/tutorial below creates a working example to compare your project to. This strategy is recommended by our Liferay Faces experts.

For the following steps, we assume someone is using a JBoss server. However, these fundamental steps can be followed for any app server. Here they are:

  1. Download a Liferay+JBoss bundle
  2. Determine the correct version of Liferay Faces: Liferay Faces Version Scheme
  3. Follow the instructions to upgrade Mojarra: For JBoss or for other app servers
  4. Follow the instructions to upgrade Weld: For JBoss or for other app servers
  5. Follow the instructions for Building Liferay Faces From Source
  6. Build the jsf2-portlet (from liferay-faces on Github) using theJBoss profile and deploy it to the Liferay+JBoss bundle:

            cd liferay-faces/demos/bridge/jsf2-portlet
            mvn -P jboss clean package
            cp target/jsf2-portlet*.war $LIFERAY_HOME/deploy


    7. Build the primefaces4-portlet (from liferay-faces on Github) using the JBoss profile and deploy it to the Liferay+JBoss bundle:


            cd liferay-faces/demos/bridge/primefaces4-portlet
            mvn -P jboss clean package
            cp target/primefaces4-portlet*.war $LIFERAY_HOME/deploy


    8. Examine the working example WARs and find out how they are different from the WARs that you are having trouble deploying. Typically it is a problem with dependencies. For example, you might be including portal-service.jar inside of WEB-INF/lib which could cause a ClassCastException.

This specific Liferay Faces troubleshooting tutorial is currently being migrated into Liferay's documentation. I'll post the link to the official tutorial to this post, once it's complete. Hope this helps!

Recycle Bin Section Now Available in Developer's Guide

Community Blogs 2014/05/08 投稿者 Cody Hoag Staff

There's been a lot of talk in the past year in regards to Liferay's new Recycle Bin framework. How do we use it? Why do we use it? Basic "user" based questions can be answered in our User Guide (Using Liferay Portal) section: Recycling Assets with the Recycle Bin. However, for a more comprehensive, in-depth guide for implementing the Recycle Bin framework for custom apps, you can now visit the Developer Guide's brand new Implementing the Recycle Bin in Your App section.

For this new Dev Guide section, we go through a detailed step-by-step guide explaining everything that is required to leverage the Recycle Bin in your personal app. Because the Recycle Bin is integrated with Liferay’s platform, configuring and implementing the Recycle Bin for your apps is easy. There are five Recycle Bin framework capabilities we discuss, in detail:

  • Moving Entries to the Recycle Bin
  • Restoring Entries from the Recycle Bin
  • Implementing the Undo Action
  • Moving/Restoring Parent Entities
  • Resolving Conflicts

While discussing these capabilities, we refer to code snippets taken from Liferay’s Jukebox Portlet plugin.
 
If you're interested in learning about the development side of Liferay's Recycle Bin framework, the Developer Guide's new section should be your first stop!
 
Special thanks to Julio Camarero and Jim Hinkey, for their helpful advice and guidance.

Liferay IDE 2.0 Documentation Now Available

Community Blogs 2014/01/06 投稿者 Cody Hoag Staff

You probably heard about the release of Liferay IDE 2.0 a couple weeks ago, but may have questions as to what is new and improved. Of course, it is compatible with the new Liferay Portal 6.2 release, but what are some of the major additions that make this release so great? The 6.1 and 6.2 Liferay Developer's Guide is now updated to describe some of these awesome new features, and also provides Liferay plugin development examples using Liferay IDE 2.0.

One of the largest additions is the brand new Liferay Plugin Project Wizard supporting both Ant (Plugins SDK) and Maven (liferay-maven-plugin) projects. This means you can now create and modify Maven projects using a graphical interface! There's also a new POM editor featuring five interactive modes, which helps you modify and organize your POM and its dependencies. Having problems resolving your POM's errors? Liferay IDE 2.0 also offers resolution generation for common pom.xml errors.

Greg Amerson wrote a couple useful blogs that introduces Liferay IDE 2.0's new features: Liferay IDE Milestone 1 Update and Liferay IDE Milestone 3 Update.

For examples and documentation on IDE's new features, visit our Working with Liferay's Developer Tools chapter in Liferay's 6.2 Developer's Guide. If you're interested in using Liferay IDE 2.0 for Liferay Portal 6.1, you can reference the Liferay IDE and Developer Studio and Developing Plugins Using Maven chapters of Liferay's 6.1 Developer's Guide. However, these aren't the only places to find IDE related information! IDE examples are sprinkled throughout the guides for most plugin development examples as well (e.g. Developing Portlet Applications chapter has IDE example for developing Liferay portlet plugins). If you're interested in using Liferay IDE 2.0, make sure to take a pitstop at Liferay's Developer's Guide!

Note: If you are interested in contributing content to the Dev Guide or any of our official documents, go to https://github.com/liferay/liferay-docs and follow the README file found in the project root and follow the guide documents found in the guidelines folder.

OpenSocial Gadgets chapter released in Development Guide

Staff Blogs 2012/10/04 投稿者 Cody Hoag Staff

It's finally here! OpenSocial gadgets is the next great topic now residing in Liferay's Development Guide. Gadgets are similar to portlets because they can be added to your portal's pages and used for all kinds of tasks. Also known as social applications, gadgets share data within well defined networks, facilitating communication of information between groups of users. Furthermore, gadgets are characterized as being simple, widely available, and easy to deploy.

This new comprehensive guide can be found in Chapter 12: Creating and Integrating with OpenSocial Gadgets in the Development Guide. The chapter introduces gadget basics, OAuth technology, PubSub, and a guide for using Liferay Portal's gadget editor. Likewise, fun examples and fully functional code snippets offer a great learning experience for developers.

If you're interested in learning more about OpenSocial gadgets or want to incorporate them into your portal, make sure to visit Liferay's Development Guide!

Kaleo Designer for Java now in Development Guide

Staff Blogs 2012/09/17 投稿者 Cody Hoag Staff

The Knowledge Management team is pleased to bring an extensive guide for one of Liferay Developer Studio's newest features: Kaleo Designer for Java. The Kaleo Designer for Java facilitates back-end Java development and scripting to incorporate in your workflows. This feature adds another dimension to working with your Kaleo workflows making it easy for Java developers to enhance workflow business logic.

This new comprehensive guide can be found in Chapter 9: Liferay IDE located within Liferay's Development Guide. The guide introduces background information, features, capabilities, set-up procedures, and a working example for developers to reference when trying out this new feature. Also, snapshots are given for a visual reference. This comprehensive guide gives you a plethora of tips and options about Kaleo Designer for Java hinged on a fun and useful workflow exercise. Lastly, you can visit Greg Amerson's video for a brief visual demo.

If you need assistance or just want to learn more about the Kaleo Designer for Java, this guide is a necessary pit-stop for your workflow development!

該当件数: 5 件