/* * $Header: /home/cvs/struts/xdocs/struts1.1/documentation/ja/src/share/org/apache/struts/actions/ForwardAction.java,v 1.4 2003/12/17 09:52:06 hioki Exp $ * $Revision: 1.4 $ * $Date: 2003/12/17 09:52:06 $ * * ==================================================================== * * The Apache Software License, Version 1.1 * * Copyright (c) 1999-2001 The Apache Software Foundation. All rights * reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * 3. The end-user documentation included with the redistribution, if * any, must include the following acknowlegement: * "This product includes software developed by the * Apache Software Foundation (http://www.apache.org/)." * Alternately, this acknowlegement may appear in the software itself, * if and wherever such third-party acknowlegements normally appear. * * 4. The names "The Jakarta Project", "Struts", and "Apache Software * Foundation" must not be used to endorse or promote products derived * from this software without prior written permission. For written * permission, please contact apache@apache.org. * * 5. Products derived from this software may not be called "Apache" * nor may "Apache" appear in their names without prior written * permission of the Apache Group. * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Software Foundation. For more * information on the Apache Software Foundation, please see * . * */ package org.apache.struts.actions; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.struts.action.Action; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionForward; import org.apache.struts.action.ActionMapping; import org.apache.struts.util.MessageResources; /** *

対応する ActionMapping の parameter * プロパティに設定された コンテキスト相対 URI に対して転送を行う * Action です。 * これは Struts の(フォームビーンの処理等の)コントローラサーブレットのもつ機能の優位性を保持したまま * Struts とサーブレット(またはJSP)で実装された他のビジネスロジックコンポーネントとを結びつけるために使用することができます。 * {@primary An Action that forwards to the context-relative * URI specified by the parameter property of our associated * ActionMapping. This can be used to integrate Struts with * other business logic components that are implemented as servlets (or JSP * pages), but still take advantage of the Struts controller servlet's * functionality (such as processing of form beans).}

* *

このアクションを使用する場合には、以下のようなエントリを * struts-config.xml ファイルに記述します: * {@primary To configure the use of this Action in your * struts-config.xml file, create an entry like this:}

* * * <action path="/saveSubscription" * type="org.apache.struts.actions.ForwardAction" * name="subscriptionForm" * scope="request" * input="/subscription.jsp" * parameter="/path/to/processing/servlet"/> * * *

このエントリでは parameter 属性で指定されたコンテキスト相対 URI * に処理を転送します。 * {@primary which will forward control to the context-relative URI specified by the * parameter attribute.}

* * @author Craig R. McClanahan * @version $Revision: 1.4 $ $Date: 2003/12/17 09:52:06 $ * @translator 高橋 一隆 * @translator 日置 聡 * @editor 未定 * @update 2003/12/17 * @status firstdraft * @memo ブロックA */ public class ForwardAction extends Action { // ----------------------------------------------------- Instance Variables /** * このパッケージのメッセージリソース。 * {@primary The message resources for this package.} */ protected static MessageResources messages = MessageResources.getMessageResources ("org.apache.struts.actions.LocalStrings"); // --------------------------------------------------------- Public Methods /** * 指定されたHTTP リクエストを処理し、対応する HTTP * レスポンスを返します(または HTTP レスポンスを生成する他の Web * コンポーネントに対して転送を行います)。 * 処理をどこにどうやって転送すべきかが記述された * ActionForward インスタンスまたは、レスポンスが既に完了している場合には * null を返します。 * {@primary Process the specified HTTP request, and create the corresponding HTTP * response (or forward to another web component that will create it). * Return an ActionForward instance describing where and how * control should be forwarded, or null if the response has * already been completed.} * * @param mapping このインスタンスを選択する際に使用された ActionMapping * {@primary The ActionMapping used to select this instance} * @param form このリクエストに対応する ActionForm(もしあれば) * {@primary The optional ActionForm bean for this request (if any)} * @param request 処理中のHTTPリクエスト * {@primary The HTTP request we are processing} * @param response 生成中のHTTPレスポンス * {@primary The HTTP response we are creating} * * @exception Exception 例外が発生した場合 * {@primary if an error occurs} */ public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { // Create a RequestDispatcher the corresponding resource String path = mapping.getParameter(); if (path == null) { response.sendError (HttpServletResponse.SC_INTERNAL_SERVER_ERROR, messages.getMessage("forward.path")); return (null); } // Let the controller handle the request ActionForward retVal = new ActionForward(path); retVal.setContextRelative(true); return retVal; } }