① out - javax.servlet.jsp.jspWriter
out对象用于把结果输出到网页上。
//方法:
//1. 清除输出缓冲区的内容,但是不输出到客户端。
void clear() ;
//2. 清除输出缓冲区的内容,并输出到客户端。
void clearBuffer() ;
//3. 关闭输出流,清除所有内容。
void close() ;
//4. 输出缓冲区里面的数据。
void flush() ;
//5. 获取以kb为单位的目前缓冲区大小。
int getBufferSize() ;
//6. 获取以kb为单位的缓冲区中未被占用的空间大小。
int getRemaining() ;
//7. 是否自动刷新缓冲区。
boolean isAutoFlush() ;
//8. 输出一个换行字符。
void newLine() ;
//9. 将指定类型的数据输出到Http流,不换行。
void print( boolean b ) ;
void print( char c ) ;
void print( char[] s ) ;
void print( double d ) ;
void print( float f ) ;
void print( int i ) ;
void print( long l ) ;
void print( Object obj ) ;
void print( String s ) ;
//10.将指定类型的数据输出到Http流,并输出一个换行符。
void println( boolean b ) ;
void println( char c ) ;
void println( char[] s ) ;
void println( double d ) ;
void println( float f ) ;
void println( int i ) ;
void println( long l ) ;
void println( Object obj ) ;
void println( String s ) ;
//11. 将一个字符或者实现了CharSequence接口的对象添加到输出流的后面。
Appendable append( char c ) ;
Appendable append( CharSequence cxq, int start, int end ) ;
Appendable append( CharSequence cxq ) ;
//成员:
int DEFAULT_BUFFER = 0 //- 缺省缓冲区大小
int NO_BUFFER = -1 //- writer是否处于缓冲输出状态
int UNBOUNDED_BUFFER = -2 //- 是否限制缓冲区大小
② request - javax.servlet.http.HttpServletRequest
request对象包含所有请求的信息,如请求的来源、标头、cookies和请求相关的参数值等。
方法:
//1. 返回由name指定的属性值,该属性不存在时返回null。
Object getAttribute( String name ) ;
//2. 返回request对象的所有属性名称的集合。
Enumeration getAttributeNames() ;
//3. 返回用来保护servlet的认证方法的名称,未受保护时返回null。
String getAuthType() ;
//4. 返回请求中的字符编码方法,可以在response对象中设置。
String getCharacterEncoding() ;
//5. 返回请求的BODY的长度,不能确定长度时返回-1。可以在response中设置。
int getContentLength() ;
//6. 返回在response中定义的内容类型。
String getContentType() ;
//7. 返回请求的路径。
String getContentPath() ;
//8. 返回客户端所有的Cookie的数组。
Cookie[] getCookies() ;
//9. 返回所有HTTP头的名称的集合。
Enumeration getHeaderNames() ;
//10. 返回指定HTTP头的所有值的集合。
Enumeration getHeaders( String name ) ;
//11. 返回指定名称的HTTP头的信息。
String getHeader( String name ) ;
//12. 返回指定名称的Data类型的HTTP头的信息。
long getDateHeader( String name ) ;
//13. 返回指定名称的Int类型的HTTP头的信息。
int getIntHeader( String name ) ;
//14. 返回请求的输入流。
ServletInputStream getInputStream() ;
//15. 返回当前页的Locale对象,可以在response中设定。
Locale getLocale() ;
//16. 返回请求中所有的Locale对象的集合。
Enumeration getLocales() ;
//17. 获取响应请求的服务器端主机名。
String getLocalName() ;
//18. 获取响应请求的服务器端地址。
String getLocalAddr() ;
//19. 获取响应请求的服务器端端口
int getLocalPort() ;
20. 获取客户端向服务器端发送请求的方法(GET、POST)。
String getMethod() ;
//21. 获取客户端发送给服务器端的参数值。
String getParameter( String name ) ;
//22. 该方法返回包含请求中所有参数的一个Map对象。
Map getParameterMap() ;
//23. 返回请求中所有参数的集合。
Enumeration getParameterNames() ;
//24. 获得请求中指定参数的所有值。
String[] getParameterValues( String name ) ;
//25. 返回get方法传递的参数字符串,该方法不分解出单独的参数。
String getQueryString() ;
//26. 取出请求中处于ServletPath和QueryString之间的额外信息。
String getPathInfo() ;
//27. 返回用getPathInfo()方法取得的路径信息的实际路径。
String getPathTranslated() ;
//28. 返回请求使用的协议。可以是HTTP1.1或者HTTP1.0。
String getProtocol() ;
//29. 返回请求的输入流对应的Reader对象,该方法和getInputStream()方法在一个
BufferedReader getReader() ;
// 页面中只能调用一个。
//30. 获取发出请求的客户端IP地址。
String getRemoteAddr() ;
//31. 获取发出请求的客户端主机名
String getRemoteHost() ;
//32. 返回经过客户端验证的用户名,未经验证返回null。
String getRemoteUser() ;
//33. 返回发出请求的客户端主机端口。
int getRemotePort() ;
//34. 返回给定虚拟路径的物理路径。
String getRealPath( String path ) ;
//35. 按给定的路径生成资源转向处理适配器对象。
RequestDispatcher getRequestDispatcher( String path ) ;
//36. 返回请求的session的标识。
String getRequestedSessionId() ;
//37. 返回发出请求的客户端地址,但是不包括请求的参数字符串。
String RequestURI() ;
//38.返回响应请求的服务器端地址
StringBuffer getRequestURI() ;
//39. 获取协议名称,缺省值为HTTP协议。
String getScheme() ;
//40. 返回响应请求的服务器名称。
String getServerName() ;
//41.获取客户端所请求的脚本文件的文件路径。
String getServletPath() ;
//42. 获取响应请求的服务器端主机端口号。
int getServerPort() ;
//43.在属性列表中删除指定名称的属性。
void removeAttribute( String name ) ;
//44. 在属性列表中添加/删除指定的属性。
void setAttribute( String name, Object value ) ;
//45. 设置请求的字符编码格式。
void setCharacterEncoding( String name ) ;
//46. 获取session,如果create为true,在无session的情况下创建一个。
HttpSession getSession() ;
HttpSession getSession( boolean create ) ;
//47. 检查请求的会话ID是否为通过Cookie传入。
boolean isRequestedSessionIdFromCookie() ;
//48. 检查请求的会话ID是否为通过URL传入。
boolean isRequestedSessionIdFromURL() ;
//49. 检查请求的会话ID是否仍然有效。
boolean isRequestedSessionIdValid() ;
//50. 检查请求是否使用安全链接,如果HTTPS等。
boolean isSecure() ;
//51. 检查已经通过验证的用户是否在是role所指定的角色。
boolean isUserInRole( String role ) ;
//52. 返回包含用户登陆名的一个java.security.Principal对象。
Principal getUserPrincipal() ;
//成员:
String BASIC_AUTH = "BASIC" -
String CLIENT_CERT_AUTH = "CLIENT_CERT" -
String DIGEST_AUTH = "DIGEST" -
String FORM_AUTH = "FORM" -
③ response - javax.servlet.http.HttpServletResponse
response对象主要将JSP容器处理后的结果传回到客户端。
// 1. 添加一个Cookie对象,保存客户端信息。
void addCookie( Cookie cookie ) ;
// 2. 添加一个日期类型的HTTP头信息,覆盖同名的HTTP头信息。
void addDateHeader( String name, long value ) ;
// 3. 添加一个HTTP头,覆盖同名的旧HTTP头。
void addHeader( String name, String value ) ;
// 4. 添加一个整型的HTTP头,覆盖同名的旧HTTP头。
void addIntHeader( String name, int value ) ;
// 5. 判断指定的HTTP头是否存在。
boolean containsHeader( String name ) ;
// 6. 对sendRedirect()方法使用的URL进行编码。
String encodeRedirectURL( String url ) ;
// 7. 将URL予以编码,回传包含session ID的URL。
String encodeURL( String url ) ;
// 8. 强制把当前缓冲区的内容发送到客户端。
void flushBuffer() ;
// 9. 取得以kb为单位的缓冲区大小。
int getBufferSize() ;
// 10. 获取响应的字符编码格式。
String getCharacterEncoding() ;
// 11. 获取响应的类型。
String getContentType() ;
// 12. 获取响应的Locale对象。
Locale getLocale() ;
// 13. 返回客户端的输出流对象。
ServletOutputStream getOutputStream() ;
// 14. 获取输出流对应的writer对象。
PrintWriter getWriter() ;
// 15. 判断服务器端是否已经将数据输出到客户端。
boolean isCommitted() ;
// 16. 清空buffer中的所有内容。
void reset() ;
// 17. 情况buffer中所有的内容,但是保留HTTP头和状态信息。
void resetBuffer() ;
// 18. 发送错误,包括状态码和错误信息。
void sendError( int xc, String msg ) ;
void sendError( int xc ) ;
// 19. 把响应发送到另外一个位置进行处理。
void sendRedirect( String locationg ) ;
// 20. 设置以kb为单位的缓冲区大小。
void setBufferSize( int size ) ;
// 21. 设置响应使用的字符编码格式。
void setCharacterEncoding( String charset ) ;
// 22. 设置响应的BODY长度。
void setContentLength( int length ) ;
// 23. 设置响应的类型。
void setContentType( String type ) ;
// 24. 设置指定名称的Data类型的HTTP头的值。
void setDateHeader( String name, long value ) ;
// 25. 设置指定名称的HTTP头的值。
void setHeader( String name, String value ) ;
// 26. 设置指定名称的int类型的HTTP头的值。
void setIntHeader( String name, int value ) ;
// 27. 设置响应状态码,新值会覆盖当前值。
void setStatus( int xc ) ;
// 成员(HTTP状态码):
int SC_CONTINUE = 100; int SC_SWITCHING_PROTOCOLS = 101;
int SC_OK = 200 ; int SC_NON_AUTHORITATIVE_INFORMATION = 203;
int SC_ACCEPTED = 202 ; int SC_CREATED = 201;
int SC_NO_CONTENT = 204 ; int SC_RESET_CONTENT = 205;
int SC_PARTIAL_CONTENT = 206 ; int SC_MULTIPLE_CHOICES = 300;
int SC_MOVED_PERMANENTLY = 301; int SC_MOVED_TEMPORARILY = 302;
int SC_FOUND = 302 ; int SC_SEE_OTHER = 303;
int SC_NOT_MODIFIED = 304; int SC_USE_PROXY = 305;
int SC_TEMPORARY_REDIRECT = 307 ; int SC_BAD_REQUEST = 400;
int SC_UNAUTHORIZED = 401 ; int SC_PAYMENT_REQUIRED = 402;
int SC_FORBIDDEN = 403 ; int SC_NOT_FOUND = 404;
int SC_METHOD_NOT_ALLOWED = 405 ; int SC_NOT_ACCEPTABLE = 406;
int SC_PROXY_AUTHENTICATION_REQUIRED = 407; int SC_REQUEST_TIMEOUT = 408;
int SC_CONFLICT = 409 ; int SC_GONE = 410;
int SC_LENGTH_REQUIRED = 411; int SC_PRECONDITION_FAILED = 412;
int SC_REQUEST_ENTITY_TOO_LARGE = 413 ; int SC_REQUEST_URI_TOO_LONG = 414;
int SC_UNSUPPORTED_MEDIA_TYPE = 415 ; int SC_REQUESTED_RANGE_NOT_SATISFIABLE = 416;
int SC_EXPECTATION_FAILED = 417 ; int SC_INTERNAL_SERVER_ERROR = 500;
int SC_NOT_IMPLEMENTED = 501 ; int SC_BAD_GATEWAY = 502;
int SC_SERVICE_UNAVAILABLE = 503 ; int SC_GATEWAY_TIMEOUT = 504;
int SC_HTTP_VERSION_NOT_SUPPORTED = 505 ;
④ session - javax.servlet.http.HttpSession
session对象表示目前个别用户的会话状态,用来识别每个用户。
//1. 获取与指定名字相关联的session属性值。
Object getAttribute( String name ) ;
//2.取得session内所有属性的集合。
Enumeration getAttributeNames() ;
//3. 返回session的创建时间,最小单位千分之一秒。
long getCreationTime() ;
//4.取得session标识。
String getId() ;
//5. 返回与当前session相关的客户端最后一次访问的时间,由1970-01-01算起,单位毫秒。
long getLastAccessedTime() ;
//6. 返回总时间,以秒为单位,表示session的有效时间(session不活动时间)。-1为永不过期。
int getMaxInactiveInterval( int interval ) ;
// 7.返回一个该JSP页面对应的ServletContext对象实例。
ServletContext getServletContext() ;
//8.获取Session上下文对象
HttpSessionContext getSessionContext() ;
//9. 取得指定名称的session变量值,不推荐使用。
Object getValue( String name ) ;
//10. 取得所有session变量的名称的集合,不推荐使用。
String[] getValueNames() ;
// 11. 销毁这个session对象。
void invalidate() ;
// 12.判断一个session是否由服务器产生,但是客户端并没有使用。
boolean isNew() ;
//13.添加一个session变量,不推荐使用。
void pubValue( String name, Object value ) ;
//14. 移除一个session变量的值,不推荐使用。
void removeValue( String name ) ;
//15. 设置指定名称的session属性值。
void setAttribute( String name, String value ) ;
//16.设置session的有效期。
void setMaxInactiveInterval( int interval ) ;
//17. 移除指定名称的session属性。
void removeAttribute( String name ) ;
⑤ pageContext - javax.servlet.jsp.PageContext
pageContext对象存储本JSP页面相关信息,如属性、内建对象等。
// 1. 在指定的共享范围内设置属性。
void setAttribute( String name, Object value, int scope ) ;
void setAttribute( String name, Object value ) ;
// 2. 取得指定共享范围内以name为名字的属性值。
Object getAttribute( String name, int scope ) ;
Object getAttribute( String name ) ;
// 3. 按页面、请求、会话和应用程序共享范围搜索已命名的属性。
Object findAttribute( String name ) ;
// 4. 移除指定名称和共享范围的属性。
void removeAttribute( String name, int scope ) ;
void removeAttribute( String name ) ;
// 5. 将页面导航到指定的URL。
void forward( String url ) ;
// 6. 取得指定共享范围内的所有属性名称的集合。
Enumeration getAttributeNamesScope( int scope ) ;
// 7. 取得指定属性的共享范围。
int getAttributeScope( String name ) ;
// 8. 取得页面的errorData对象。
ErrorData getErrorDate() ;
// 9. 取得页面的exception对象。
Exception getException() ;
// 10. 取得页面的expressionEvaluator对象。
ExpressionEvaluator getExpressionEvaluator() ;
// 11. 取得页面的out对象。
JspWriter getOut() ;
// 12. 取得页面的page对象。
Object getPage() ;
// 13. 取得页面的request对象。
ServletRequest getRequest() ;
// 14. 取得页面的response对象。
ServletResponse getResponse() ;
// 15. 取得页面的config对象。
ServletConfig getConfig() ;
// 16. 取得页面的servletContext对象。
ServletContext getServletContext() ;
// 17. 取得页面的session对象。
HttpSession getSession() ;
// 18. 取得页面的variableResolver对象。
VariableResolver getVariableResolver() ;
// 19. 包含其他的资源,并指定是否自动刷新。
void include( String url, boolean flush ) ;
void include( String url ) ;
// 20. 重置pageContext内部状态,释放所有内部引用。
void release() ;
// 21. 初始化未经初始化的pageContext对象。
void initialize( Servlet servlet, ServletRequest request, ServletResponse response,
String errorPageURL, boolean needSession, int bufferSize, boolean autoFlush ) ;
// 22. 保存当前的out对象,并更新pageContext中page范围内的out对象。
BodyContext pushBody() ;
BodyContext pushBody( Writer writer ) ;
// 23. 取出由pushBody()方法保存的out对象。
JspWrite popBody() ;
24.
void handlePageException( Exception e ) ;
void handlePageException( Thrwoable t ) ;
//成员:
int PAGE_SCOPE = 1;// - 页面共享范围
int REQUEST_SCOPE = 2 ;// - 请求共享范围
int SESSION_SCOPE = 3;// - 会话共享范围
int APPLICATION_SCOPE = 4 ;//- 应用程序共享范围
String PAGE = "javax.servlet.jsp.jspPage";
String PAGECONTEXT = "javax.servlet.jsp.jspPageContext";
String REQUEST = "javax.servlet.jsp.jspRequest";
String RESPONSE = "javax.servlet.jsp.jspResponse";
String CONFIG = "javax.servlet.jsp.jspConfig";
String SESSION = "javax.servlet.jsp.jspSession";
String OUT = "javax.servlet.jsp.jspOut";
String APPLICATION = "javax.servlet.jsp.jspApplication";
String EXCEPTION = "javax.servlet.jsp.jspException" ;
⑥ application - javax.servlet.ServletContext
application主要功用在于取得或更改Servlet的设定。
// 方法:
// 1. 返回由name指定的application属性。
Object getAttribute( String name ) ;
// 2. 返回所有的application属性。
Enumeration getAttributes() ;
// 3. 取得当前应用的ServletContext对象。
ServletContext getContext( String uripath ) ;
// 4. 返回由name指定的application属性的初始值。
String getInitParameter( String name ) ;
// 5. 返回所有的application属性的初始值的集合。
Enumeration getInitParameters() ;
// 6. 返回servlet容器支持的Servlet API的版本号。
int getMajorVersion() ;
// 7. 返回指定文件的类型,未知类型返回null。一般为"text/html"和"image/gif"。
String getMimeType( String file ) ;
// 8. 返回servlet容器支持的Servlet API的副版本号。
int getMinorVersion() ;
// 9. 返回给定虚拟路径所对应物理路径。
String getRealPath( String path ) ;
// 10. 为指定名字的Servlet对象返回一个RequestDispatcher对象的实例。
RequestDispatcher getNamedDispatcher( String name ) ;
// 11. 返回一个RequestDispatcher对象的实例。
RequestDispatcher getRequestDispatcher( String path ) ;
// 12. 返回指定的资源路径对应的一个URL对象实例,参数要以"/"开头。
URL getResource( String path ) ;
// 13. 返回一个由path指定位置的资源的InputStream对象实例。
InputStream getResourceAsStream( String path ) ;
// 14. 返回存储在web-app中所有资源路径的集合。
Set getResourcePaths( String path ) ;
// 15. 取得应用服务器版本信息。
String getServerInfo() ;
// 16. 在ServletContext中检索指定名称的servlet。
Servlet getServlet( String name ) ;
// 17. 返回ServletContext中所有servlet的集合。
Enumeration getServlets() ;
// 18. 返回本web应用的名称。
String getServletContextName() ;
// 19. 返回ServletContext中所有servlet的名称集合。
Enumeration getServletContextNames() ;
// 20. 把指定的信息写入servlet log文件。
void log( Exception ex, String msg ) ;
void log( String msg, Throwable t ) ;
void log( String msg ) ;
// 21. 移除指定名称的application属性。
void removeAttribute( String name ) ;
// 22. 设定指定的application属性的值。
void setAttribute( String name, Object value ) ;
⑦ config - javax.servlet.ServletConfig
config对象用来存放Servlet初始的数据结构。
//1.返回名称为name的促使参数的值。
String getInitParameter( String name ) ;
//2.返回这个JSP所有的促使参数的名称集合。
Enumeration getInitParameters() ;
// 3. 返回执行者的servlet上下文。
ServletContext getContext() ;