Sample Servlets

For all of the sample servlets, the class files are provided and are packaged in the jar file com.peoplesoft.crm.omk.examples.jar.

where selected_path is the pathname where you chose to install the files.

The test Java servlet named HelloWorld can be used to test custom content extensions. The following shows the source for this servlet.

//******************************************************************/
//        Confidentiality Information:                              /
//                                                                  /
// This module contains confidential and proprietary information    /
// of PeopleSoft, Inc.; it is not to be copied, reproduced, or      /
// transmitted in any form, by any means, in whole or in part,      /
// nor is it to be used for any purpose other than that for         /
// which it is expressly provided under the applicable license      /
// agreement.                                                       /
//                                                                  /
// Copyright (c) 2000-2002 PeopleSoft, Inc. All Rights Reserved.    /
//******************************************************************/
/*--- formatted by Jindent 2.1, (www.c-lab.de/~jindent) ---*/

package com.peoplesoft.crm.omk.external;
import java.io.PrintWriter;

/**
* HelloWorld servlet simply outputs the string "Hello World!"
*/
public class HelloWorld extends GenericAnnuncioServlet
{
		/**
		* HelloWorld constructor.
		*/
		public HelloWorld()
		{
			super();
		}
		/**
		* Retrieves the servlet info string
		* @return String the servlet info string
		*/
			public String getServletInfo()
		{
			return ("HelloWorld, Annuncio Software, 4/2000");
		}
		/**
		* service method.
		*/
		public void service(javax.servlet.ServletRequest req, 	
		javax.servlet.ServletResponse res) 
				throws javax.servlet.ServletException, java.io.IOException
{
		PrintWriter out = res.getWriter();
		if (out != null)
	{
			out.print("Hello World!");
		}
		else
		{
			System.err.println("Can't get a PrintWriter.");
		}
	}
}
/*--- formatting done in "Annuncio Convention" style on 06-20-2000 ---*/

The SampleLiveExtension servlet is a custom content extension that builds HTML on a web page based on a content’s profile information. It shows how to achieve the following operations:

• Pass parameters, including profile information, to a Online Marketing Extension

• Retrieve external data to be merged into a document

• Manage a cache to improve performance while ensuring thread safety:

  • Refresh mechanism

  • Access synchronization

• Log error messages to the Online Marketing log files

This section is divided into the following subsections:

• Audience: who should use this Online Marketing Extension?

• Functionality: What the Online Marketing Extension does

• Content storage: How the extension stores the content in files

• Cache mechanism: Which rules determine the reloading of the content

• Registering the extension: How to register the extension with the Online Marketing Dialog Server

• Using the extension: How to build a simple dialog using this extension

<path_value>\<state_abbreviation>.txt

C:\states\CA.txt

Population=33,145,121 inhabitants
Area=158,869 square miles
Senators=Barbara Boxer, Dianne Feinstein

<pstag:extension name="SampleLiveExtension"
 id="">

An additional sample servlet, EXStockQuotes, is also provided. It is similar to the SampleLiveExtension servlet.

You can use the EXStockQuotes servlet in three different ways within Online Marketing dialogs:

• Insert it directly into broadcast or follow-up emails

• Insert it directly into web documents

• Insert it into the Content section(s) of a Dynamic Content object in an email document

In the third scenario the extension is used to retrieve content posted at an external URL, while the conditions specifying which content is to be displayed to whom are set up within the Dynamic Content object (in Online Marketing). Typically in this case, as in this sample, one or two parameters would be passed to retrieve the appropriate content. Each Content Section of the Dynamic Content object could have an extension inserted to retrieve content, or the Dynamic Content object could have a mix where some Content Sections have internally-stored content (content that is inserted or copy/pasted into the Content tab) while other Content Sections have an extension designed to retrieve content.