jcx.servlet
Class Servlet1

java.lang.Object
  |
  +--javax.servlet.GenericServlet
        |
        +--javax.servlet.http.HttpServlet
              |
              +--jcx.servlet.Servlet1

All Implemented Interfaces:

java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig, javax.servlet.SingleThreadModel

public abstract class Servlet1

extends javax.servlet.http.HttpServlet

implements javax.servlet.SingleThreadModel

此類別 Servlet 為一Servlet 之基礎類別, 凡是所有Servlet 程式均須要為繼承此類別另做發展。

See Also:

Serialized Form

Constructor Summary

Servlet1()

Method Summary

void	addCookie(javax.servlet.http.Cookie cookie) 對 Client 端送出 Cookie,必須在 returnNormalResponse 前執行，否則無效.
java.lang.String	getClientProperty(java.lang.String prop) 取得 Client 端的屬性 .
javax.servlet.http.Cookie[]	getCookies() 得到 Browser 端的 Cookie.
java.io.FileInputStream	getFileInputStream(java.lang.String key) 傳回 Client 端檔案上傳資料的 FileInputStream.
java.util.Hashtable	getFormData() 傳回 Client 端呼叫此 Servlet 全部的參數.
java.io.InputStream	getInputStream() 得到 Browser 端資料的 InputStream.
java.lang.String	getMethod() 傳回呼叫本程式的 Method 如 GET,POST.
java.io.PrintStream	getOutputStream() 得到 對 Browser 端輸出資料的 PrintStream.
java.lang.String	getParameter(java.lang.String key) 傳回 Client 端呼叫此 Servlet 的單一參數.
java.lang.String	getPath() 傳回本程式的路徑(含程式名稱) 如 /server-java/Hello , /servlet/HelloWorld.
boolean	returnAuthenticateResponse() 對 Client 端送出 HTTP/1.0 401 Unauthorized 的訊號，並設定 realm 為 Java Composer.
boolean	returnAuthenticateResponse(java.lang.String realm) 對 Client 端送出 HTTP/1.0 401 Unauthorized 的訊號，並設定 realm.
boolean	returnErrorResponse(java.lang.String s1, int ii) 對 Client 端送出 HTTP/1.1 400 unknown reason 的訊號，並設定 content-type 為 s1.
boolean	returnNormalResponse(java.lang.String s1) 對 Client 端送出 HTTP 200 O.K 的訊號，並設定 content-type 為 s1.
void	run() Servlet 保留用途，程式由 run1 開始執行，不允許 override
abstract void	run1() Servlet 程式的進入點，程式由 run1 開始執行
protected void	service(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse resp)

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, init, log, log

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Servlet1

public Servlet1()

Method Detail

service

protected void service(javax.servlet.http.HttpServletRequest req,
                       javax.servlet.http.HttpServletResponse resp)
                throws javax.servlet.ServletException,
                       java.io.IOException

Overrides:

service in class javax.servlet.http.HttpServlet

getFormData

public java.util.Hashtable getFormData()

傳回 Client 端呼叫此 Servlet 全部的參數.

Returns:

Hashtable represented the Parameter.

getParameter

public java.lang.String getParameter(java.lang.String key)

傳回 Client 端呼叫此 Servlet 的單一參數.

Parameters:

key - 參數名稱,如果參數不存在則傳回 null.

Returns:

參數的 value

getFileInputStream

public final java.io.FileInputStream getFileInputStream(java.lang.String key)
                                                 throws java.io.IOException

傳回 Client 端檔案上傳資料的 FileInputStream.

所謂檔案上傳是以 multipart/form-data 格式上傳的方式,
 Exam.
	

	
	
檔案上傳
	
使用者代號: Jony
	
	

	
 檔案名稱: 
	

	
	

  程式寫法
  String user_id=getParameter("id");

  FileInputStream fin=getFileInputStream("uploadfile");
	

Parameters:

key - 參數名稱,如果參數不存在則傳回 null.

Returns:

上傳資料的 FileInputStream.

Throws:

java.io.IOException - if an I/O error occurs.

run

public final void run()
               throws java.lang.Exception

Servlet 保留用途，程式由 run1 開始執行，不允許 override

run1

public abstract void run1()
                   throws java.lang.Exception

Servlet 程式的進入點，程式由 run1 開始執行

Returns:

none

Throws:

java.lang.Exception - if any Exception.

getInputStream

public java.io.InputStream getInputStream()

得到 Browser 端資料的 InputStream.

Returns:

Browser 端資料的 InputStream

getOutputStream

public java.io.PrintStream getOutputStream()

得到 對 Browser 端輸出資料的 PrintStream.

Returns:

Browser 端資料的 PrintStream

getCookies

public javax.servlet.http.Cookie[] getCookies()

得到 Browser 端的 Cookie.

Returns:

Cookie 陣列,如果 Client 端沒有送出 Cookie ,則回傳零長度的陣列

addCookie

public void addCookie(javax.servlet.http.Cookie cookie)

對 Client 端送出 Cookie,必須在 returnNormalResponse 前執行，否則無效.

Parameters:

cookie - 欲送出給 Client 端的 Cookie.

Returns:

none

returnNormalResponse

public boolean returnNormalResponse(java.lang.String s1)

對 Client 端送出 HTTP 200 O.K 的訊號，並設定 content-type 為 s1.

Parameters:

String - 欲送出給 Client 端的 content-type ,如 text/html , image/gif 等等.

Returns:

永遠為 true.

returnAuthenticateResponse

public boolean returnAuthenticateResponse(java.lang.String realm)

對 Client 端送出 HTTP/1.0 401 Unauthorized 的訊號，並設定 realm.

Parameters:

String - 欲送出給 Client 端的 realm.

Returns:

永遠為 true

returnAuthenticateResponse

public boolean returnAuthenticateResponse()

對 Client 端送出 HTTP/1.0 401 Unauthorized 的訊號，並設定 realm 為 Java Composer.

Parameters:

none. -

Returns:

永遠為 true

returnErrorResponse

public boolean returnErrorResponse(java.lang.String s1,
                                   int ii)

對 Client 端送出 HTTP/1.1 400 unknown reason 的訊號，並設定 content-type 為 s1.

Parameters:

String - 欲送出給 Client 端的 content-type ,如 text/html , image/gif 等等.

int - 保留，未使用，請傳入零即可.

Returns:

永遠為 true.

getPath

public java.lang.String getPath()

傳回本程式的路徑(含程式名稱) 如 /server-java/Hello , /servlet/HelloWorld.

Returns:

傳回本程式的路徑(含程式名稱),不含參數.

getMethod

public java.lang.String getMethod()

傳回呼叫本程式的 Method 如 GET,POST.

Returns:

呼叫本程式的 Method 如 GET,POST.

getClientProperty

public java.lang.String getClientProperty(java.lang.String prop)

取得 Client 端的屬性 .

Parameters:

prop - 傳入 ip.

Returns:

Client 端的 IP Address .