![]() |
![]() |
|
|
| |
プログラミングの概要
以下の節では、基本的な HTTP サーブレットのプログラミングについて説明します。
この節では、Hello World
というメッセージを出力する単純な HTTP サーブレットを記述する手順について説明します。これらの手順を示すサンプル コード(HelloWorldServlet
)の全文がこの節の最後にあります。JDBC、RMI、JMSなど各種の J2EE および WebLogic Server サービスをサーブレットで使用する方法の詳細については、このマニュアルで後述します。
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
javax.servlet.http.HttpServlet
を拡張します。次に例を示します。
public class HelloWorldServlet extends HttpServlet{
service()
メソッドを実装します。
サーブレットの主要な機能は、Web ブラウザからの HTTP リクエストを受け取って、HTTP 応答を返すことです。この処理は、サーブレットの service()
メソッドによって行われます。サービス メソッドには、出力を生成する応答オブジェクトと、クライアントからのデータを受け取るリクエスト オブジェクトがあります。
これ以外にも、doPost()
メソッドや doGet()
メソッドを実装したサーブレットのサンプルを見たことがあるかもしれません。これらのメソッドは、POST または GET リクエストにのみ応答するものです。service()
メソッドを実装しておけば、1 つのメソッドですべてのリクエスト タイプを処理できます(ただし、service()
メソッドを実装した場合、このメソッドの最初で super.service()
を呼び出さない限り、doPost()
メソッドや doGet()
メソッドを実装することはできません)。HTTP サーブレットの仕様ではこれ以外に、他のリクエスト タイプの処理に使用されるメソッドも解説していますが、全部をまとめて、サービス メソッドと総称しています。
サービス メソッドはすべて、同じパラメータ引数を取ります。HttpServletRequest
は、リクエストの情報を提供し、HttpServletResponse
は HTTP クライアントに応答する際にサーブレットによって使用されます。サービス メソッドは次のようになります。
public void service(HttpServletRequest req,
HttpServletResponse res) throws IOException
{
res.setContentType("text/html");
java.io.PrintWriter
オブジェクトへの参照を取得します。
PrintWriter out = res.getWriter();
PrintWriter
オブジェクトに対し println()
メソッドを使用して、HTML を生成します。
out.println("<html><head><title>Hello World!</title></head>");
out.println("<body><h1>Hello World!</h1></body></html>");
}
}
WEB-INF
\classes
ディレクトリに、サーブレットをコンパイルします。次に例を示します。
javac -d /myWebApplication/WEB-INF/classes myServlet.java
サーブレットの呼び出しに使用する URL は、(a)そのサーブレットが含まれる Web アプリケーション名、(b)Web アプリケーションのデプロイメント記述子にマップされるサーブレット名によって決まります。リクエスト パラメータも、サーブレットを呼び出す URL に含まれることがあります。
一般的には、サーブレットの URL は以下のパターンに従います。
http://
host
:port
/webApplicationName/mappedServletName
?parameter
URL の各要素は次のように定義します。
host
は、WebLogic Server が稼動しているマシンの名前。
port
は、上記マシンが HTTP リクエストをリスンしているポート。
webApplicationName
は、サーブレットが含まれる Web アプリケーションの名前。
たとえば、examplesWebApp
にデプロイされ、自分のマシンで稼動している WebLogic Server から提供される HelloWorldServlet
(このマニュアルで使われているサンプル)を Web ブラウザで呼び出す場合、次のような URL を入力します。
http://localhost:7001/examplesWebApp/HelloWorldServlet
URL の host
:
port
部分は、WebLogic Sever にマップされている DNS 名に置き換えることもできます。
上記の手順で、基本的なサーブレットが作成できます。サーブレットでは、さらに高度な機能を使用することもできます。
init()
メソッドをオーバーライドできます。
この節では、前述の手順で使用した Java ソース コード サンプルの全文を示します。このサンプルは HTTP リクエストに応答する簡単なサーブレットです。このマニュアルの後半では、このサンプルを拡張することにより、HTTP パラメータ、クッキー、およびセッション トラッキングの使い方を説明します。
コード リスト 2-1 HelloWorldServlet.java
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
public class HelloWorldServlet extends HttpServlet {
public void service(HttpServletRequest req,
HttpServletResponse res)
throws IOException
{
// 先にコンテンツ タイプを設定する
res.setContentType("text/html");
// ここで HTML を挿入する PrintWriter を取得する
PrintWriter out = res.getWriter();
out.println("<html><head><title>" +
"Hello World!</title></head>");
out.println("<body><h1>Hello World!</h1></body></html>");
}
}
WebLogic Server 配布キットの samples
\examples
\servlets
ディレクトリに、このソース コードと、このマニュアルで使われている全サンプルをコンパイルして実行するための手順説明があります。
![]() |
![]() |
![]() |