내장객체
-
[JSP강의노트] 제5강 JSP의 내장 객체들2009.10.07
[JSP강의노트] 제5강 JSP의 내장 객체들
2009. 10. 7. 01:45
JSP 내장객체
pageContext 객체
(javax.servlet.jsp.PageContext)
현재 JSP 문서과 관련된 속성외에 다른 내장 객체의 속성을 얻을 수 있는 막강한 기능의 내장객체입니다. 다른 내장 객체의 속성을 얻기 위해 메서드의 매개변수로 범위를 나타내는 정수 값을 전달해야 합니다.
내장 객체를 얻기 위한 메서드
- public abstract Exception getException()
- 예외 발생 시 이를 처리하도록 지정된 에러 문서를 리턴합니다.
- public abstract JspWriter getOut()
- out 내장 객체를 리턴합니다.
- public abstract Object getPage()
- page 내장 객체를 리턴합니다. 해당 JSP 문서에 대한 서블릿 인스턴스 객체를 리턴합니다.
- public abstract ServletRequest getRequest()
- request 내장 객체를 리턴합니다.
- public abstract ServletResponse getResponse()
- response 내장 객체를 리턴합니다.
- public abstract ServletConfig getServletConfig()
- config 내장 객체를 리턴합니다. 해당 문서에 대한 서블릿 초기 설정 정보를 얻을 수 있습니다.
- public abstract ServletContext getServletContext()
- application 내장 객체를 리턴합니다. 해당 JSP 문서에 대한 서블릿이 실행되는 환경 정보를 얻을 수 있습니다.
- public abstract HttpSession getSession()
- session 내장 객체를 리턴합니다.
요청 처리할 제어권의 위임과 관련한 메서드
- public abstract void forward(String urlPath) throws ServletException, IOException
- 현재 JSP 문서의 request 객체와 response 객체를 forward() 메서드로 호출한 문서에게 전달합니다. 주소창의 주소늘 불변입니다.
- public abstract void include(String urlPath) throws ServletException, IOException
- 현재 JSP 문서의 request 객체와 response 객체를 include() 메서드로 호출한 문서에게 전달하여 처리한 후 처리가 끝나면 다시 제어권을 현재 문서로 가지고 옵니다. 지정된 문서를 끼워넣는 효과가 있습니다.
속성을 읽고 설정하는 메서드
- public abstract Object getAttribute(String name)
- page 생존 범위의 속성 값을 리턴합니다.
- public abstract void setAttribute(String name, Object value)
- page 생존 범위의 name 속성에 값을 저장합니다.
- public abstract Object findAttribute(String name)
- page, request, session, application 범위의 순서대로 name 속성이 존재하는지 확인하여 결과값을 리턴합니다.
- public abstract Object getAttribute(String name, int scope)
- 지정된 범위의 name 속성 값을 리턴합니다. PageContext.APPLICATION_SCOPE, PageContext.PAGE_SCOPE, PageContext.REQUEST_SCOPE, PageContext.SESSION_SCOPE 의 범위 정수 값을 지정할 수 있습니다.
- public abstract void setAttribute(String name, Object value, int scope)
- 지정된 범위의 name 속성에 값을 저장합니다. 범위 정수 값은 위 설명과 같습니다.
session 내장 객체
(javax.servlet.http.HttpSession)
- public String getId()
- 해당 세션의 세션ID를 리턴합니다.
- public long getCreateTime()
- 1970년 1월 1일 0시 0분 0초를 기준으로 session이 생성된 시간을 밀리초 단위로 리턴합니다.
- public long getLastAccessedTime()
- 가장 최근에 요청이 시도된 시간을 밀리초 단위로 리턴합니다.
- public int getMaxInactiveInterval()
- 클라이언트의 요청이 없을 경우 해당 세션의 최대 유지 시간을 초 단위로 리턴합니다.
- public void invalidate()
- 해당 세션을 종료합니다.
- public boolean isNew()
- 새로운 세션이 생성될 경우 true를 리턴하고 기존 세션이 유지되고 있는 상태일 경우 false를 리턴합니다.
- public void setMaxInactiveInterval(int second)
- 세션 유지 최대 시간을 초 단위로 설정합니다.
application 내장 객체
(javax.servlet.ServletContext)
특정 웹 어플리케이션 전체에 설정한 정보를 얻을 수 있습니다. 서버의 정보와 자원에 대한 정보를 얻고, 어플리케이션이 실행하는 동안 발생할 수 있는 이벤트 로그 등 관련 기능을 제공합니다.
어플리케이션 실행 환경을 제공하는 서버의 정보 관련 메서드
- public int getMajorVersion()
- Servlet API spec.의 주 버전을 리턴합니다.
- public int getMinorVersion()
- Servlet API spec.의 보조 버전을 리턴합니다.
- public String getServerInfo()
- Servlet/JSP container의 버전을 리턴합니다.
서버측 자원 정보 관련 메서드
- public String getMimeType(String filename)
- 지정된 파일의 MIME 형식을 리턴합니다.
- public java.net.URL getResource(String path)
- path로 지정된 자원을 URL 객체로 리턴합니다. 서버측 자원의 접근 용도로 사용됩니다.
- public InputStream getResourceAsStream(String path)
- path로 지정된 자원을 입력 스트림 객체로 리턴합니다.
- public String getRealPath(String path)
- path로 지정된 자원의 실제 경로를 리턴합니다.
어플리케이션 이벤트 로그 관련 메서드
- public void log(String msg)
- 메시지를 지정된 로그 파일에 저장합니다.
- public void log(String msg, java.lang.Throwable exception)
- 메시지와 예외 스택 트레이스 정보를 로그 파일에 저장합니다.
out 내장 객체
(javax.servlet.jsp.JspWriter)
전송할 응답에 대한 출력 스트림 객체입니다.
- public abstract void clear() throws IOException
- 출력 버퍼의 내용을 사용하지 않고 지워버립니다.
- public boolean isAutoFlush()
- 출력 버퍼가 가득찰 경우 자동으로 flush 하여 클라이언트로 전송할 수 있도록 ture가 설정되었는지 확인합니다. (page 지시어의 buffer 속성 참고)
- public int getBufferSize()
- 바이트 단위로 지정된 버퍼의 크기를 리턴합니다. (page 지시어의 buffer 속성 참고)
- public abstract int getRemaining()
- 버퍼의 남은 양을 바이트 단위로 리턴합니다.
- public abstract void clearBuffer() throws IOException
- 현재 출력 버퍼에 저장된 내용을 삭제합니다. clear() 메서드의 경우 flush된 경우 예외를 발생시키지만 clearBuffer() 메서드는 현재 버퍼의 사용을 취소하는 것이므로 예외는 발생하지 않습니다. 입출력시 예외가 발생할 수 있습니다.
- public abstract void flush() throws IOException
- 출력 버퍼의 내용을 비워버리고 클라이언트로 즉시 전송합니다.
- public abstract void close() throws IOException
- 출력 버퍼의 내용을 flush하고 스트림을 닫습니다.
config 내장 객체
(javax.servlet.ServletConfig)
서블릿 인스턴스가 참조할 초기 설정 정보를 얻을 수 있습니다.
- public String getInitParameter(String init_paramName)
- Servlet/JSP container 설정 파일에 지정된 초기 파라메터의 값을 리턴합니다.
- public Enumeration getInitParameterNames()
- Servlet/JSP container 설정 파일에 지정된 초기 파라메터의 이름들을 리턴합니다.
page 내장 객체
(javax.servlet.jsp.HttpJspPage)
JSP 문서에서 생성된 서블릿 인스턴스 객체를 참조합니다. 현재 대부분의 JSP 컨테이너가 지원하는 스크립트 언어가 Java이므로 거의 사용되지 않습니다.
exception 내장 객체
JSP 문서에서 발생한 예외를 처리할 페이지를 지정한 경우 에러 페이지에 전달되는 예외 객체입니다. (page 지시어의 isErrorPage 속성 참고)
public String getMessage()
에러 메시지를 리턴합니다.
public void printStackTrace()
에러 출력 스트림(System.err)으로 스택 트레이스 정보를 출력합니다.
public void printStackTrace(java.io.PrintWriter out)
스택 트레이스 정보를 지정된 출력 스트림으로 출력합니다.