Sunday, February 10, 2013

STRUTS ACTION HOOK


To extend the CreateAccountAction ,  there are different types of hook to achieve  . Here we are going to discuss about Struts Action Hook.


Steps 1 : Add the struts action path and your custom implementation file in liferay-hook.xml :

<struts-action>
<struts-action-path>/login/create_account</struts-action-path> 
<struts-action-impl>com.liferay.login.hook.action.CustomCreateAccountAction</struts-action-impl>
</struts-action>

Step 2: Create custom implemetation file [CustomCreateAccountAction] in above mentioned location . [com.liferay.login.hook.action]

public class CustomCreateAccountAction extends BaseStrutsPortletAction{

public CustomCreateAccountAction() {
// TODO Auto-generated constructor stub
}

@Override
public void processAction(StrutsPortletAction originalStrutsPortletAction,
PortletConfig portletConfig, ActionRequest actionRequest,
ActionResponse actionResponse) throws Exception {
// TODO Auto-generated method stub
System.out.println("inside the process actionwhile creating the account>>>");
super.processAction(originalStrutsPortletAction, portletConfig, actionRequest,
actionResponse);
}

@Override
public String render(StrutsPortletAction originalStrutsPortletAction,PortletConfig portletConfig,
RenderRequest renderRequest, RenderResponse renderResponse)
throws Exception {
// TODO Auto-generated method stub
System.out.println("inside the render action while creating the account>>>");
return super.render(portletConfig, renderRequest, renderResponse);
}
}


Step 3: deploy.

Done. But sometime you might confuse when we need to extend BaseStrutsPortletAction and BaseStrutsAction.

Struts action interfaces:

com.liferay.portal.kernel.struts.StrutsAction
com.liferay.portal.kernel.struts.StrutsPortletAction

The StrutsAction interface is for regular Struts actions, like /c/portal/update_email_address, from the portal
The StrutsPortletAction interface is used for similar Struts actions from portlets.

Note: If you use BaseStrutsAction, you should override "execute" method:

public class SampleStrutsAction extends BaseStrutsAction {  
@Override 
public String execute(StrutsAction originalStrutsAction, HttpServletRequest request, HttpServletResponse response) throws Exception {  
System.out.println("SampleLayoutStrutsAction.execute() - " + request.getRequestURI());  
return originalStrutsAction.execute(request, response); 
}  
}


Exceptions :


1. "Cannot be Cast" Exception

Some time if you get an exception like "ActionAdapter cannot be cast to PortletActionAdapter" or "PortletActionAdapter cannot be cast to ActionAdapter"

To resolve that:

ActionAdapter cannot be cast to PortletActionAdapter :

    you have implemneted BaseStrutsAction instead of BaseStrutsPortletAction

2) PortletActionAdapter cannot be cast to ActionAdapter :

    you have implemneted BaseStrutsPortletAction instead of BaseStrutsAction

2.  "Forward Does not exist" Exception

If you get an exception like this , then In render method of custom implementation file [CustomCreateAccountAction ] before return statement, 
we need to change that behavier by setting renderRequest.setAttribute(WebKeys.PORTLET_DECORATE, Boolean.TRUE); 

use this :

String ret = originalStrutsPortletAction.render(null, portletConfig, renderRequest, renderResponse);
 renderRequest.setAttribute(WebKeys.PORTLET_DECORATE, Boolean.TRUE);
 return ret;


instead of ,

return originalStrutsPortletAction.render(null, portletConfig, renderRequest, renderResponse);

3.  If It doesn't redirect to Original Path

After successfully implementing struts action hook, If it doesn't redirect to it's original path, you need to use originalStrutsPortletAction in processAction method.

 For example after creating the user , if it stays in same create account page instead of login page which is default behaviour, then use like this :

originalStrutsPortletAction.processAction(portletConfig, actionRequest, actionResponse);

instead of,

super.processAction(originalStrutsPortletAction, portletConfig, actionRequest,actionResponse);

if any queries , please contact gnaniyar@gmail.com 

- Gnaniyar Zubair
gnaniyar@gmail.com

Thursday, June 21, 2012

Publish Version Hook Plugin

Publish Version Hook  Plugin

This article is described about the Custom Publish Version hook which is available in Community plugins. Using this hook, we can revert back old version of journal aticle easily.

Journal Portlet:

The Journal portlet provides a user interface to the admin or content owner to add , edit , delete ,expire  the articles and displaying all the versions of  article.

All versions will be displayed in the list of available Journal Articles as shown below:

(Edit Article --> View History)

A new version will be generated automatically if article is modified

Version Handling

Managing version is having  some limitations in Liferay that users cannot publish the old version of the article. If user s want to publish the old version, they should expire all the versions of the article which we cannot revert back once done. 

eg.,  a  article has more than 100  versions since  it has been modified for 100 times, but  user wants to re-publish   1.1 version which is initial version of the article. Then, they have to expire all  99 versions [ 1.2  to  1.100 ]  which is hectic and not safe for expiring all the articles  in a huge content management portal as anytime we may need to revert back  some version of the article.

Publish Version Hook

 

So,  I have developed  struts action Hook plugin by customizing jsp(s)  and action files of the  journal article  for publishing any version of the article.

This  PublishVersion-Hook  plugin helps  article's admin or content owner to re-publish the article without expiring the old versions.  User cannot publish the Multi Articles or Expired article  and Latest version.

 

 

Use Cases :

 

  1. Update the Article through web content display portlet  or control panel.

     2.   A new version will be generated automatically if article is modified each time.

     3.   Click  View History section where all the version of the articles will be displayed as shown below

 

 

4.    Select old version of the article and click Publish.

 

 

5.  You cannot publish Latest / Expired / Multiple articles at a time .

 

 

Technical Explanation:

I have developed this plug-in in Struts Action Hook.   Reason for developing Struts Action Hook is, I was planning to learn Struts Action Hook for long time since this new feature introduced. So, finally done it. J

I have overridden the existing Struts Action /journal/edit_article which extends BaseStrutsPortletAction and    In View History Page [view_article_history.jsp &   article_version_action.jsp], new Publish buttons are added to publish the selected version.   

When publishing  the  selected version, it is redirecting to Custom Struts Action class where I have written my logic to change the selected version's count  as latest version by increasing 1 with latest version.   So automatically latest version will be displayed.

 

JournalArticle selectedVersionObject = JournalArticleLocalServiceUtil.getArticle(selectedId);

selectedVersionObject.setVersion(latestVersion+Math.abs(0.1));   //increasing 1 with latest version

JournalArticleLocalServiceUtil.updateJournalArticle(selectedVersionObject);

 

If any queries / suggestion about this hook, Please feel free to reach me : gnaniyar@gmail.com

 

-  Gnaniyar Zubair

gnaniyar@gmail.com

Saturday, March 17, 2012

Invitation to connect on LinkedIn

 
LinkedIn
 
 
 
Gnaniyar zubair
 
From Gnaniyar zubair
 
Senior Software Engineer - Portal Technology at Mahindra Satyam
India
 
 
 

I'd like to add you to my professional network on LinkedIn.

- Gnaniyar

 
 
 
 
 
 
You are receiving Invitation to Connect emails. Unsubscribe
© 2012, LinkedIn Corporation. 2029 Stierlin Ct. Mountain View, CA 94043, USA
 

Thursday, March 3, 2011

Solr Integration with Liferay

Solr Integration with Liferay

Solr is the popular, blazing fast open source enterprise search platform from the Apache Lucene project. Its major features include powerful full-text search, hit highlighting, faceted search, dynamic clustering, database integration, and rich document (e.g., Word, PDF) handling. Solr is highly scalable, providing distributed search and index replication, and it powers the search and navigation features of many of the world's largest internet sites. Refer to Apache Solr

This document shows how to integrate Solr within Liferay Portal. Note that Liferay portal version must be 6 or above.

Integration steps :

1 . Download the latest Solr from this link. Extract somewhere this zip file, and I will call this extracted folder as SOLR_HOME.

  1. Download the solr-web-6.0.1.1 war file and deploy the war file in liferay tomcat server.

  2. Copy the schema.xml file from the solr-web/WEB-INF/conf folder which is deployed and paste/replace in SOLR_HOME/example/solr/conf folder.

  3. Change the solr url as follows in solr-spring.xml which is located in solr-web/WEB-INF/classes/META-INF/ folder.

Change from this content :

<bean id="solrServer"
class="com.liferay.portal.search.solr.server.BasicAuthSolrServer">

<constructor-arg type="java.lang.String" value="http://localhost:8080/solr" />

</bean>

to this :

<bean id="solrServer"
class="com.liferay.portal.search.solr.server.BasicAuthSolrServer">

<constructor-arg type="java.lang.String" value="http://localhost:8983/solr" />

</bean>


Note :
8983 is the default port for Solr.
  1. Now shutdown the tomcat server.

  2. Start the Solr server using the following command from SOLR_HOME/examle folder in command prompt/terminal.

Java -jar start.jar

  1. Start the liferay tomcat server now.

  2. Now add the search portlet in your home page and test your searches. When ever you search anything you can see some log info in solr server.

Note : By defaut Solr searches for the new webcontent, wiki, blogs... etc from the time Solr is integrated. To search the complete portal reindex all search indexs from the server administration which is in control panel.

Friday, December 24, 2010

Mail Portlet Synchronization Issue

Liferay Portlet doesn't Synchronize all the mails properly. Though it shows the Mail Count in Pagination,the Pagination fails to work properly at a certain level.

This is due to some unusual characters in subject/sender/to/body in your mails.

You can resolve this by changing some column types from "mail_message" table.

Step 1: Please make sure that your database character set is "UTF-8".If it isn't then create it as follows:

create database testing character set utf-8



Step 2: Change "longtext" to "binary" for some column from "mail_message" table

as follows:

alter table Mail_Message modify column sender longtext character set binary;

alter table Mail_Message modify column to_ longtext character set binary;

alter table Mail_Message modify column cc longtext character set binary;

alter table Mail_Message modify column bcc longtext character set binary;

alter table Mail_Message modify column body longtext character set binary;

alter table mail_message modify column sender longtext charecter set binary

Fileupload using service.xml file

I have done this in MVC portlet. File upload in liferay using service.xml file is bit tricky. With small modification in portlet-model-hints.xml we can achieve this.

Step 1: Give the data type as string to store the uploaded file.

entry in service.xml file

<entity name="FileUploader" table="fileuploader" local-service="true">

<column name="fid" type="long" primary="true"/>

<column name="content" type="String"/>

</entity>

Step 2 : Do 'ant build-service' from specific portlet level. As you know that which is used to generate the api to interact with database.

Step 3 : Open 'portlet-model-hints.xml' file which is in 'WEB-INF/src/META-INF'.

Initially this xml file look like this

<model-hints>

<model name="com.sample.mvc.model.FileUploader">

<field name="fid" type="long" />

<field name="content" type="String" />

</model>

</model-hints>

Depending on this xml file script files will generate which are in 'sql' folder.

Define 'hint-collection' tag for the 'content' column where i am storing the file content in this example.

Modified file will be as shown below.

<model-hints>

<model name="com.sample.mvc.model.FileUploader">

<field name="fid" type="long" />

<field name="content" type="String">

<hint-collection name="CLOBTYPE" />

</field>

</model>

<hint-collection name="CLOBTYPE">

<hint name="max-length">2000000</hint>

</hint-collection>

</model-hints>

Step 4 : Now do again 'ant build-service' to update the corresponding script files. This will update the sql script file. We can see the datatype of 'content' column in sql script as TEXT. When we deploy it will create CLOB type column in your database.

Step 5 : Write this logic in your action class to get the file from the jsp page and store it into the database.

public void abc(ActionRequest arq,ActionResponse ars) throws Exception {

UploadPortletRequest uploadRequest = PortalUtil.getUploadPortletRequest(arq);

FileUploader fileUp = new FileUploaderImpl();

fileUp.setFid(CounterLocalServiceUtil.increment("FileUploader.class"));

File file = uploadRequest.getFile("file");

byte[] bytes = FileUtil.getBytes(file);

fileUp.setContent(Base64.objectToString(bytes));

FileUploaderLocalServiceUtil.addFileUploader(fileUp);

}

Your JSP page something look like this :

<%@ taglib uri="http://java.sun.com/portlet_2_0" prefix="portlet" %>

<portlet:defineObjects />

<%@page import="javax.portlet.PortletURL"%>

<portlet:actionURL name="abc" var="actionURL1"></portlet:actionURL>

<form action="<%= actionURL1.toString() %>" method="post" enctype="multipart/form-data">

Name : <input type="text" name="urname" />

<input type="file" name="file"/>

<input type="submit" value="Submit" />

</form>

Saturday, December 4, 2010

Get Remote IP

To get the Client System's (Remote) IP Address through portlet request:


HttpServletRequest request = PortalUtil.getHttpServletRequest(actionrequest);
String clientIp = PortalUtil.getOriginalServletRequest(request).getRemoteAddr();


or


String clientIp = PortalUtil.getHttpServletRequest(request).getRemoteAddr();

--
Warm Regards,

K.Gnaniyar Zubair,

Share & Enjoy

Twitter Delicious Facebook Digg Stumbleupon Favorites More