第４章　アクションタグ

# **アクションタグ**

***

## **1.アクションタグの紹介**
標準アクションとはJSPで最初から用意されているタグです。

```<jsp:アクション名 属性名1=属性値1 属性名2=属性値2 ... >```

* 「jsp」はプリフィックス名です。

* タグは標準タグ以外にも自分で定義したカスタムタグなどがありますが、タグを一まとめにしたものをタグライブラリと言います。プリフィックス名はどのタグライブラリを使うのかを指定するのに使われます。

* アクション名は、タグ一覧の中でどのJavaコードを実行するのかを識別するためのものです。

<table border="1">
<tr style="width:400px ;background-color:#C6E0B4 ;text-align:center;">
<th>標準アクション</th>
<th>説明</th>
</tr>
<tr>
<td>< jsp:forward > </td>
<td>リクエストを他のページへ転送する</td>
</tr>
<tr>
<td>< jsp:param > </td>
<td>< jsp:forward >によって転送される際にパラメータを追加する</td>
</tr>
<tr>
<td>< jsp:include ></td>
<td>他のページの結果をインクルードする</td>
</tr><tr>
<td>< jsp:plugin ></td>
<td>JavaプラグインによってJavaアプレットを実行する</td>
</tr><tr>
<td>< jsp:fallback ></td>
<td>Javaアプレットプラグイン（Applet plug-in） が起動できない場合に表示されるコンテンツを指定する</td>
</tr><tr>
<td>< jsp:useBean ></td>
<td>Beanのインスタンス化を行う</td>
</tr><tr>
<td>< jsp:getProperty ></td>
<td>Beanからプロパティを取得する</td>
</tr><tr>
<td>< jsp:setProperty ></td>
<td>Beanにプロパティを設定する</td>
</tr><tr>
<td>< jsp:attribute ></td>
<td>属性地を設定する</td>
</tr><tr>
<td>< jsp:body ></td>
<td>タグボディを定義する</td>
</tr><tr>
<td>< jsp:doBody ></td>
<td>タグボディを実行する</td>
</tr><tr>
<td>< jsp:invoke ></td>
<td>フラグメント（Fragments、断片）を実行する</td>
</tr>
</table>

<br>

## **2.重要なアクションタグ**

### **2-1.forwardアクション**

「forward」アクションは他のHTMLページやJSPページへフォワードする場合に利用します。
「forward」アクションの書式は次の通りです。

```
<jsp:forward page="転送先のページ" />
```

属性値として「page」に対してフォワード先のHTMLページ又はJSPページを指定します。
ページはアクションを記述するJSPページからの相対パスで指定して下さい。
「forward」アクションを記述する場合は、画面に対する出力を行う前に記述する必要があります。<br>

+ **forwardFrom.jsp**
```
<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<!DOCTYPE html>
<jsp:forward page="forwardTo.jsp" />
<html>
<head>
<title>forwardテスト</title>
</head>
<body>
	<h1>forwardテスト</h1>
</body>
</html>
```

+ **forwardTo.jsp**
```
<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<!DOCTYPE html >
<html>
<head>
<title>転送先ページ</title>
</head>
<body>
	<h1>転送先ページ</h1>
</body>
</html>
```

+ **実行結果**(fowardFrom.jsから実行します)
  <h1>転送先ページ</h1>

<br>

### **2-2.paramアクション**
「param」アクションを「forward」アクションと同時に用いることで、フォワードされる時にフォワード先に渡すリクエストに新しいパラメータを追加して渡すことができます。
「param」アクションの書式は次の通りです。

```
<jsp:param name="パラメータ名" value="値" />
```

「param」アクションは属性値として「name」にパラメータ名と、「value」に格納する値を指定します。
「forward」アクションと組み合わせて利用する場合には「forward」アクションの子要素として定義します。
パラメータは必要な数だけ記述して下さい。

```
<jsp:forward page="転送先のページ">
<jsp:param name="パラメータ名1" value="値1" />
<jsp:param name="パラメータ名2" value="値2" />
</jsp:forward>
```

フォワード先のJSPページ又はサーブレットでは、渡されてきたパラメータを「getParameter」又は「getParameterValues」を使って値を取り出すことができます。(「getParameter」については『リクエストパラメータの取得(getParameter)』を参照して下さい)。

```
String val = request.getParameter("paramName");
```
<br>

### **2-3.includeアクション**
「include」アクションは指定したHTMLページやJSPページを指定の場所へインクルードします。
「include」アクションの書式は次の通りです。

```
<jsp:include page="インクルードするページ" flush="true | false" />
```

属性値として「page」に対してインクルードするHTMLページ又はJSPページを指定します。
ページはアクションを記述するJSPページからの相対パスで指定して下さい。
また「flush」に「true」を設定するとインクルードを行う前にバッファをフラッシュしてクライアントへ出力します。デフォルトでは「false」となっており省略可能です。<br>

+ **include.jsp**
```
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head><title>includeテスト</title></head>
<body>
　<h1>includeテスト</h1>
　<jsp:include page="includeSrc.jsp" />
</body>
</html>
```

+ **includeSrc.jsp**
```
<%@ page contentType="text/html;charset=UTF-8"%>
<%@ page import="java.util.Date"%>
<p>インクルードされた部分です</p>
<%
  out.println(new Date());
%>
```
+ **実行結果**(include.jspから実行します)
  <h1>includeテスト</h1><br>
  <br>
  インクルードされた部分です<br>
  Sun Nov 03 14:12:03 JST 2019

<br>

### **2-4.includeアクション と includeディレクティブの違い**

「include」アクションは「include」ディレクティブと似ていますが、「include」ディレクティブは指定したページに記載されている内容をそのまま取り込んで一つのページとして扱います。
それに対して「include」アクションの場合は指定したページを実際に実行した結果を取り込みます。
つまり「include」ディレクティブの場合は1つのJSPページとなりますが、「include」アクションの場合は2つのJSPページがそれぞれサーブレットに変換されて動作することになります。
その為、「include」アクションの方はインクルードされるページの方も単独で動作するように記述が必要です。具体的に言うとインクルードされる方のページで次の記述が無かった場合、そのページ内で日本語を使っていると文字化けします。

```
<%@ page contentType="text/html;charset=UTF-8" %>
```

「include」ディレクティブであれば、指定したページの出力ではなくページに書かれている内容をインクルード元のページに取り込みますのでインクルードされるページの方には文字コードの指定は不要です。

<br>

### **2-5.include+paramアクション**
「param」アクションを「include」アクションと同時に用いることで、インクルードされるページが実行される際にパラメータとして渡すことができます。
「include」アクションを利用する際に「param」アクションも利用する場合は次のように記述します。

```
<jsp:include page="インクルードするページ">
<jsp:param name="パラメータ名1" value="値1" />
<jsp:param name="パラメータ名2" value="値2" />
</jsp:include>
```

インクルード先のページでパラメータを取り出すには「getParameter」又は「getParameterValues」を使って値を取り出します。

+ **include2.jsp**
```
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head><title>includeテスト</title></head>
<body>
　<h1>includeテスト</h1>
　<jsp:include page="includeSrc2.jsp" >
　  <jsp:param name="textsize" value="h1" />
　</jsp:include>
</body>
</html>
```

+ **includeSrc2.jsp**
```
<%@ page contentType="text/html;charset=UTF-8"%>
<%@ page import="java.util.Date"%>
<p>インクルードされた部分です</p>
<%
  String textsize = request.getParameter("textsize");
%>
<<%= textsize %>><%= new Date() %></<%= textsize %>>
```

+ **実行結果**(include2.jspから実行します)
  <h1>includeテスト</h1><br>
  <br>
  インクルードされた部分です<br>
  <h1>Sun Nov 03 14:34:43 JST 2019</h1>

<br>

### **2-6.pluginアクション**
「plugin」アクションはJavaアプレットをJSPページ内に表示させるために使います。<br>
「plugin」アクションの書式は次の通りです。
```
<jsp:plugin
  type="タイプ"
  code="クラス名"
  codebase="コードベース"
  jreversion="JREバージョン"
  width="幅"
  height="高さ">
</jsp:plugin>
```

「type」には「applet」を指定します。「code」にはアプレットのクラスファイルを指定します。
「codebase」にはアプレットが置かれているディレクトリをドキュメントルートからの絶対パスで指定します。
「jreversion」には利用するJREのバージョンを指定します。
「width」「height」にはアプレットの幅と高さを指定します。

content

第４章 アクションタグ

第４章　アクションタグ