com.oreilly.servlet

类 HttpMessage

java.lang.Object

com.oreilly.servlet.HttpMessage

直接已知子类:

HttpsMessage

public class HttpMessage
extends Object

A class to simplify HTTP applet-server communication. It abstracts the communication into messages, which can be either GET or POST.

It can be used like this:

 URL url = new URL(getCodeBase(), "/servlet/ServletName");
  
 HttpMessage msg = new HttpMessage(url);
  
 // Parameters may optionally be set using java.util.Properties
 Properties props = new Properties();
 props.put("name", "value");
  
 // Headers, cookies, and authorization may be set as well
 msg.setHeader("Accept", "image/png");             // optional
 msg.setCookie("JSESSIONID", "9585155923883872");  // optional
 msg.setAuthorization("guest", "try2gueSS");       // optional
  
 InputStream in = msg.sendGetMessage(props);
 

This class is loosely modeled after the ServletMessage class written by Rod McChesney of JavaSoft.

版本:

1.3, 2000/10/24, fixed headers NPE bug, 1.2, 2000/10/15, changed uploaded object MIME type to application/x-java-serialized-object, 1.1, 2000/06/11, added ability to set headers, cookies, and authorization, 1.0, 1998/09/18

作者:

Jason Hunter, Copyright © 1998

构造器概要

构造器

构造器和说明
HttpMessage(URL servlet) Constructs a new HttpMessage that can be used to communicate with the servlet at the specified URL.

方法概要

限定符和类型	方法和说明
InputStream	sendGetMessage() Performs a GET request to the servlet, with no query string.
InputStream	sendGetMessage(Properties args) Performs a GET request to the servlet, building a query string from the supplied properties list.
InputStream	sendPostMessage() Performs a POST request to the servlet, with no query string.
InputStream	sendPostMessage(Properties args) Performs a POST request to the servlet, building post data from the supplied properties list.
InputStream	sendPostMessage(Serializable obj) Performs a POST request to the servlet, uploading a serialized object.
void	setAuthorization(String name, String password) Sets the authorization information for the request (using BASIC authentication via the HTTP Authorization header).
void	setCookie(String name, String value) Sets a request cookie with the given name and value.
void	setHeader(String name, String value) Sets a request header with the given name and value.

从类继承的方法 java.lang.Object

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

构造器详细资料

HttpMessage

public HttpMessage(URL servlet)

Constructs a new HttpMessage that can be used to communicate with the servlet at the specified URL.

参数:

servlet - the server resource (typically a servlet) with which to communicate

方法详细资料

sendGetMessage

public InputStream sendGetMessage()
                           throws IOException

Performs a GET request to the servlet, with no query string.

返回:

an InputStream to read the response

抛出:

IOException - if an I/O error occurs

sendGetMessage

public InputStream sendGetMessage(Properties args)
                           throws IOException

Performs a GET request to the servlet, building a query string from the supplied properties list.

参数:

args - the properties list from which to build a query string

返回:

an InputStream to read the response

抛出:

IOException - if an I/O error occurs

sendPostMessage

public InputStream sendPostMessage()
                            throws IOException

Performs a POST request to the servlet, with no query string.

返回:

an InputStream to read the response

抛出:

IOException - if an I/O error occurs

sendPostMessage

public InputStream sendPostMessage(Properties args)
                            throws IOException

Performs a POST request to the servlet, building post data from the supplied properties list.

参数:

args - the properties list from which to build the post data

返回:

an InputStream to read the response

抛出:

IOException - if an I/O error occurs

sendPostMessage

public InputStream sendPostMessage(Serializable obj)
                            throws IOException

Performs a POST request to the servlet, uploading a serialized object.

The servlet can receive the object in its doPost() method like this:

     ObjectInputStream objin =
       new ObjectInputStream(req.getInputStream());
     Object obj = objin.readObject();
 

The type of the uploaded object can be determined through introspection.

参数:

obj - the serializable object to upload

返回:

an InputStream to read the response

抛出:

IOException - if an I/O error occurs

setHeader

public void setHeader(String name,
                      String value)

Sets a request header with the given name and value. The header persists across multiple requests. The caller is responsible for ensuring there are no illegal characters in the name and value.

参数:

name - the header name

value - the header value

setCookie

public void setCookie(String name,
                      String value)

Sets a request cookie with the given name and value. The cookie persists across multiple requests. The caller is responsible for ensuring there are no illegal characters in the name and value.

参数:

name - the header name

value - the header value

setAuthorization

public void setAuthorization(String name,
                             String password)

Sets the authorization information for the request (using BASIC authentication via the HTTP Authorization header). The authorization persists across multiple requests.

参数:

name - the user name

password - the user password