WebSphere Portal 编程: 普及的 Portlet 开发

package com.ibm.wps.samples.weather;
import java.io.*;
import org.apache.jetspeed.portlet.*;
import org.apache.jetspeed.portlets.*;
/**
 * WeatherPortlet.java ™Simple Example to display weather.
 */
public class WeatherPortlet extends AbstractPortlet {
  public void init(PortletConfig portletConfig) throws UnavailableException {
      super.init(portletConfig);
  }
  public void service(PortletRequest request, PortletResponse response)
    throws PortletException, IOException {
      PrintWriter writer = response.getWriter();
      writer.println("<p>The weather is 78 degress.</p>");
  }
}

package com.ibm.wps.samples.weather;
import java.io.*;
import vendor.service.weather.*;
import org.apache.jetspeed.portlet.*;
import org.apache.jetspeed.portlets.*;
import org.apache.jetspeed.portlet.service.*;
/**
 * WeatherPortlet.java ™A more extensive example to display weather.
 */
public class WeatherPortlet extends PortletAdapter {
  protected static final String jsp =
    "/WEB-INF/weather/html/DisplayWeather.jsp";
  public void init(PortletConfig portletConfig) throws UnavailableException {
      super.init(portletConfig);
  }
  public void doView(PortletRequest request, PortletResponse response)
    throws PortletException, IOException {
      // Create a Weather Bean.
      WeatherBean weatherBean = new WeatherBean();               
         
      // Get the portlet session.
      PortletSession session = request.getPortletSession();
      // Get the portlet configuration.
      PortletConfig config = getPortletConfig();
      // Get the portlet context.
      PortletContext context = config.getContext(); 
      // Get portal user object.
      User user = session.getUser(); 
      // Get the user's full name or null if not available.
      weatherBean.setFullName(user.getFullName()); 
      // Get the weather service for determining the temperature.
      WeatherService weatherService = 
        (WeatherService)context.getService(WeatherService.class);
      // Get the current temperature for the specified zip code.
      weatherBean.setTemperature(
        weatherService.getTemperature(
          Integer.parseInt(config.getInitParameter("ZipCode"))));
      // Put the bean in the request.
      request.setAttribute("weatherBean", weatherBean); 
      // Invoke the JSP to do the actual rendering for the portlet view.
      context.include(jsp, request, response);
  }
}

...
public void service(PortletRequest request, PortletResponse response)
  throws PortletException, IOException {
    // Get the mode of the portlet.
    Portlet.Mode mode = request.getMode();
    if (mode == Portlet.Mode.VIEW)
      doView(request, response);
    else if (mode == Portlet.Mode.EDIT)
      doEdit(request, response);
    else if (mode == Portlet.Mode.HELP)
      doHelp(request, response);
    else if (mode == Portlet.Mode.CONFIGURE)
      doConfigure(request, response);
}
...

package com.ibm.wps.samples.weather;
/**
 * WeatherBean.java ?A bean used to pass data to the JSP display.
 */
public class WeatherBean {
  /** The user's full name. */
  private String fullName = "";
  /** The current temperature. */
  private int degrees = 0;
  public void setFullName(String name) {
    fullName = name;
  }
  public String getFullName() {
    return fullName;
  }
  public void setTemperature(int degrees) {
    this.degrees = degrees;
  }
  public int getTemperature() {
    return degrees;
  }
}

<!----------------------------------------------------------------------------->
<!--                                                                         -->
<!-- DisplayWeather.jsp - A JSP used to render the data for the weather      -->
<!-- portlet.                                                                -->
<!--                                                                         -->
<!----------------------------------------------------------------------------->
<%@ page contentType="text/html" errorPage="" %>
<jsp:useBean id="weatherBean"
     class="com.ibm.wps.samples.weather.WeatherBean"
     scope="request"/>
<p>
Hi <%= weatherBean.getFullName() == null ? "" : weatherBean.getFullName() %>!
<br>
The current temperature in your area is <%= weatherBean.getTemperature() %>.

package com.ibm.wps.samples.weather;
import java.io.*;
import com.ibm.wps.portlets.*;
import vendor.service.weather.*;
import org.apache.jetspeed.portlet.*;
import org.apache.jetspeed.portlets.*;
import org.apache.jetspeed.portlet.service.*;
/**
 * WeatherBaseController.java
 * Base controller class containing common controller functionality.
 */
public class WeatherBaseController extends AbstractPortletController {
  /** The View for HTML devices (e.g. Internet Explorer, Netscape). */
  protected String jspHTML = "/WEB-INF/weather/html/";
  
  /** The View for WML devices (e.g. SmartPhones). */
  protected String jspWML = "/WEB-INF/weather/wml/";
 
  public void init(PortletConfig config)
    throws UnavailableException {
      super.init(config);
      // Load the HTML View from the configuration
      jspHTML += config.getInitParameter("view.HTML");
 
      // Load the WML View from the configuration.
      jspWML += config.getInitParameter("view.WML");
  }
  protected void createBean(PortletRequest request, PortletResponse response) {
      // Get the portlet configuration object.
      PortletConfig config = getPortletConfig();
      // Create a Weather Bean.
      WeatherBean weatherBean = new WeatherBean();               
      // Set the user's full name or null if not available.
      weatherBean.setFullName(
        request.getPortletSession().getUser().getFullName());                              
      // Get the weather service for determining the temperature.
      WeatherService weatherService = 
        (WeatherService)config.getContext().getService(WeatherService.class);
      // Get the current temperature for the specified zip code.
      weatherBean.setTemperature(
        weatherService.getTemperature(
          Integer.parseInt(config.getInitParameter("ZipCode"))));
      // Insert bean into the request for the JSP to use.
      request.setAttribute("weatherBean", weatherBean);
  }  
}

package com.ibm.wps.samples.weather;
import java.io.*;
import com.ibm.wps.portlets.*;
import org.apache.jetspeed.portlet.*;
/**
 * WeatherHTMLController.java
 * Controller for calling the HTML View.
 */
public class WeatherHTMLController extends WeatherBaseController {
  public void doView(PortletRequest request, PortletResponse response)
    throws PortletException, IOException {
      createBean(request, response);
      getPortletConfig().getContext().include(jspHTML, request, response);
  }
}

package com.ibm.wps.samples.weather;
import java.io.*;
import com.ibm.wps.portlets.*;
import org.apache.jetspeed.portlet.*;
/**
 * WeatherWMLController.java
 * Controller for calling the WML View.
 */
public class WeatherWMLController extends WeatherBaseController {
  public void doView(PortletRequest request, PortletResponse response)
    throws PortletException, IOException {
      createBean(request, response);
      getPortletConfig().getContext().include(jspWML, request, response);
  }
}

...
  <servlet-name>WeatherPortlet</servlet-name>
  <servlet-class>com.ibm.wps.portlets.MVCPortlet</servlet-class>
  <init-param>
    <param-name>controller.html</param-name>
    <param-value>com.ibm.wps.samples.weather.WeatherHTMLController</param-value>
  </init-param>
  
  <init-param>
    <param-name>controller.wml</param-name>
    <param-value>com.ibm.wps.samples.weather.WeatherWMLController</param-value>
  </init-param>
  
  <init-param>
    <param-name>view.HTML</param-name>
    <param-value>DisplayWeatherHTML.jsp</param-value>
  </init-param>
  <init-param>
    <param-name>view.WML</param-name>
    <param-value>DisplayWeatherWML.jsp</param-value>
  </init-param>
  <init-param>
    <param-name>ZipCode</param-name>
    <param-value>27709</param-value>
  </init-param>
...

<!----------------------------------------------------------------------------->
<!-- DisplayWeatherHTML.jsp - A JSP view for rendering HTML.                 -->
<!----------------------------------------------------------------------------->
<%@ page contentType="text/html" errorPage="" %>
<jsp:useBean id="weatherBean"
     class="com.ibm.wps.samples.weather.WeatherBean"
     scope="request"/>
<p>
Hi <%= weatherBean.getFullName() == null ? "" : weatherBean.getFullName() %>!
<br>
The current temperature in your area is <%= weatherBean.getTemperature() %>.

<!----------------------------------------------------------------------------->
<!-- DisplayWeatherWML.jsp - A JSP view for rendering WML.                   -->
<!----------------------------------------------------------------------------->
<%@ page contentType="text/wml" errorPage="" %>
<jsp:useBean id="weatherBean"
     class="com.ibm.wps.samples.weather.WeatherBean"
     scope="request"/>
<p align="left">
Current temperature is <%= weatherBean.getTemperature() %>.
</p>

Nokia-Communicator-WWW-browser/3.0 (Geos 3.0 Nokia-9110)

<!----------------------------------------------------------------------------->
<!-- DisplayWeatherWML.jsp - A JSP view for rendering WML using the          -->
<!-- capabilities of the device.                                             -->
<!----------------------------------------------------------------------------->
<%@ page contentType="text/wml" errorPage="" %>
<%@ page import="org.apache.jetspeed.portlet.*" %>
<jsp:useBean id="weatherBean"
     class="com.ibm.wps.samples.weather.WeatherBean"
     scope="request"/>
<!-- Add statements so that we can access the portlet request/response. -->
<%@ taglib uri="/WEB-INF/tld/portlet.tld" prefix="portletAPI" %>
<portletAPI:init />
<p align="left">
  <% if (portletRequest.getClient().isCapableOf(Capability.WML_TABLE)) { %>
    <table columns="1">
      <tr><td>
        Hi <%= weatherBean.getFullName() == null ? "" :
               weatherBean.getFullName() %>!
      </td></tr>
      <tr><td>          
        Current temperature is <%= weatherBean.getTemperature() %>.
      </td></tr>
    </table>
  <% } else { %>
    Current temperature is <%= weatherBean.getTemperature() %>.
  <% } %>
</p>

...
<font class="wpsPortletText">
  Current temperature is <%= weatherBean.getTemperature() %>.
</font>
...

...
<!-- For a device that support CSS. --> 
<font class="wpsPortletText">
  Current temperature is <%= weatherBean.getTemperature() %>.
</font>
...

...
<!-- For a device that does NOT support CSS. -->
        
<font size="1" face="sans-serif">
  Current temperature is <%= weatherBean.getTemperature() %>.
</font>
...

/**
 * StyleBean.java
 * An abstraction layer for creating a views based on the capabilities of a 
 * client.  For example, CSS support vs. no CSS support.
 */
public abstract class StyleBean {
  /**
   * Initialize the bean.
   * @param   request  The portlet request object.
   */
  public abstract void init(PortletRequest request);
  /**
   * Method to call to insert the font style guideline content.
   * @param   styleClass  The name of the style class.
   * @return  The markup to insert into the JSP for starting a font.
   */
  public abstract String startFont(String styleClass);
  /**
   * Method to call to insert the font style guideline content.
   * @param   styleClass  The name of the style class.
   * @return  The markup to insert into the JSP for ending a font.
   */
  public abstract String endFont(String styleClass);
}

<!----------------------------------------------------------------------------->
<!-- DisplayWeatherHTML.jsp - A JSP view for rendering HTML for both         -->
<!-- browsers and Pocket PC devices.                                         -->
<!----------------------------------------------------------------------------->
<%@ page contentType="text/html" errorPage="" %>
<%@ page import="org.apache.jetspeed.portlet.*" %>
<%@ page import="com.ibm.wps.style.*" %>
<jsp:useBean id="weatherBean"
     class="com.ibm.wps.samples.weather.WeatherBean"
     scope="request"/>
<jsp:useBean id="styleBean"
     class="com.ibm.wps.style.StyleBean"
     scope="request"/>
<!-- Add statements so that we can access the portlet request/response. -->
<%@ taglib uri="/WEB-INF/tld/portlet.tld" prefix="portletAPI" %>
<portletAPI:init />
<!-- Initialize the style bean. -->
<% styleBean.init(portletRequest); %>
<!----------------------------------------------------------------------------->
<p>
<%= styleBean.startFont("wpsPortletText") %>
  The current temperature in your area is <%= weatherBean.getTemperature() %>.
<%= styleBean.endFont("wpsPortletText") %>
</p>

package com.ibm.wps.style;
import java.io.*;
import java.util.*;
import org.apache.jetspeed.portlet.*;
public class StyleBean {
  /** The resource that defines the style values. */
  private ResourceBundle resource = null;
  public void init(PortletRequest request) {
    // Determine whether the client device supports CSS and if not,
    // then load the resource style values.
    if (!request.getClient().isCapableOf(Capability.HTML_CSS)) {
      
      try {
    
        // Retrieve the resource bundle from the classpath.
        resource = ResourceBundle.getBundle("com.ibm.wps.style.NoCSS");
      }
      catch (Exception e) {
        // Resource bundle not available.
        resource = null;
    }}      
  }
  public String startFont(String styleClass) {
    // If the client supports CSS, use class identifier.
    if (resource == null) {
      return "<font class=\"" + styleClass + "\">";
    }
    // If the client does not support CSS, use the style values.
    String markup = "<font size=\"" +
                    resource.getString(styleClass + ".font.size") +
                    "\" face=\"" +
                    resource.getString(styleClass + ".font.face") +
                    "\">";
    return markup;
  }
  public String endFont(String styleClass) {
    return "</font>";
  }
}

wpsPortletText.font.size = 1
wpsPortletText.font.face = sans-serif