public class MockHttpServletResponse extends ObjectSE implements HttpServletResponseEE
HttpServletResponse
EE インターフェースのモック実装。Spring Framework 5.0 以降、このモックのセットは Servlet 4.0 ベースラインに基づいて設計されています。
SC_ACCEPTEDEE, SC_BAD_GATEWAYEE, SC_BAD_REQUESTEE, SC_CONFLICTEE, SC_CONTINUEEE, SC_CREATEDEE, SC_EXPECTATION_FAILEDEE, SC_FORBIDDENEE, SC_FOUNDEE, SC_GATEWAY_TIMEOUTEE, SC_GONEEE, SC_HTTP_VERSION_NOT_SUPPORTEDEE, SC_INTERNAL_SERVER_ERROREE, SC_LENGTH_REQUIREDEE, SC_METHOD_NOT_ALLOWEDEE, SC_MOVED_PERMANENTLYEE, SC_MOVED_TEMPORARILYEE, SC_MULTIPLE_CHOICESEE, SC_NO_CONTENTEE, SC_NON_AUTHORITATIVE_INFORMATIONEE, SC_NOT_ACCEPTABLEEE, SC_NOT_FOUNDEE, SC_NOT_IMPLEMENTEDEE, SC_NOT_MODIFIEDEE, SC_OKEE, SC_PARTIAL_CONTENTEE, SC_PAYMENT_REQUIREDEE, SC_PRECONDITION_FAILEDEE, SC_PROXY_AUTHENTICATION_REQUIREDEE, SC_REQUEST_ENTITY_TOO_LARGEEE, SC_REQUEST_TIMEOUTEE, SC_REQUEST_URI_TOO_LONGEE, SC_REQUESTED_RANGE_NOT_SATISFIABLEEE, SC_RESET_CONTENTEE, SC_SEE_OTHEREE, SC_SERVICE_UNAVAILABLEEE, SC_SWITCHING_PROTOCOLSEE, SC_TEMPORARY_REDIRECTEE, SC_UNAUTHORIZEDEE, SC_UNSUPPORTED_MEDIA_TYPEEE, SC_USE_PROXYEE
コンストラクターと説明 |
---|
MockHttpServletResponse() |
修飾子と型 | メソッドと説明 |
---|---|
void | addCookie(CookieEE cookie) 指定した Cookie をレスポンスに追加します。 |
void | addDateHeader(StringSE name, long value) 指定された名前と日付値を持つレスポンスヘッダーを追加します。 |
void | addHeader(StringSE name, StringSE value) 指定された名前と値でレスポンスヘッダーを追加します。 |
void | addIncludedUrl(StringSE includedUrl) |
void | addIntHeader(StringSE name, int value) 指定された名前と整数値を持つレスポンスヘッダーを追加します。 |
boolean | containsHeader(StringSE name) 名前付きレスポンスヘッダーがすでに設定されているかどうかを示すブール値を返します。 |
StringSE | encodeRedirectUrl(StringSE url) 使用すべきではありません。 |
StringSE | encodeRedirectURL(StringSE url) デフォルトの実装は encodeURL(java.lang.String) に委譲し、指定された URL 文字列をそのまま返します。 |
StringSE | encodeUrl(StringSE url) 使用すべきではありません。 |
StringSE | encodeURL(StringSE url) デフォルトの実装は、指定された URL 文字列をそのまま返します。 |
void | flushBuffer() バッファ内のコンテンツを強制的にクライアントに書き込みます。 |
int | getBufferSize() レスポンスに使用される実際のバッファサイズを返します。 |
StringSE | getCharacterEncoding() このレスポンスで送信される本文に使用される文字エンコード(MIME 文字セット)の名前を返します。 |
byte[] | getContentAsByteArray() |
StringSE | getContentAsString() |
int | getContentLength() |
long | getContentLengthLong() |
StringSE | getContentType() このレスポンスで送信される MIME 本文に使用されるコンテンツ型を返します。 |
CookieEE | getCookie(StringSE name) |
CookieEE[] | getCookies() |
long | getDateHeader(StringSE name) |
StringSE | getErrorMessage() |
StringSE | getForwardedUrl() |
StringSE | getHeader(StringSE name) 指定されたヘッダーのプライマリ値を String として返します(存在する場合)。 |
CollectionSE<StringSE> | getHeaderNames() 指定されたすべてのヘッダーの名前を文字列のセットとして返します。 |
ListSE<StringSE> | getHeaders(StringSE name) 指定されたヘッダーのすべての値を文字列のリストとして返します。 |
ObjectSE | getHeaderValue(StringSE name) 存在する場合、指定されたヘッダーのプライマリ値を返します。 |
ListSE<ObjectSE> | getHeaderValues(StringSE name) 指定されたヘッダーのすべての値を値オブジェクトのリストとして返します。 |
StringSE | getIncludedUrl() |
ListSE<StringSE> | getIncludedUrls() |
LocaleSE | getLocale() ServletResponse.setLocale(java.util.Locale) EE メソッドを使用して、このレスポンスに指定されたロケールを返します。 |
ServletOutputStreamEE | getOutputStream() レスポンスにバイナリデータを書き込むのに適した ServletOutputStream EE を返します。 |
StringSE | getRedirectedUrl() |
int | getStatus() このレスポンスの現在のステータスコードを取得します。 |
PrintWriterSE | getWriter() クライアントに文字テキストを送信できる PrintWriter オブジェクトを返します。 |
boolean | isCharset() 文字エンコーディングが設定されているかどうかを返します。 |
boolean | isCommitted() レスポンスがコミットされたかどうかを示すブール値を返します。 |
boolean | isOutputStreamAccessAllowed() getOutputStream() アクセスが許可されているかどうかを返します。 |
boolean | isWriterAccessAllowed() getOutputStream() アクセスが許可されているかどうかを返します。 |
void | reset() バッファーに存在するすべてのデータとステータスコード、ヘッダーをクリアします。 |
void | resetBuffer() ヘッダーまたはステータスコードをクリアせずに、レスポンスの基になるバッファのコンテンツをクリアします。 |
void | sendError(int status) 指定されたステータスコードを使用してエラーレスポンスをクライアントに送信し、バッファをクリアします。 |
void | sendError(int status, StringSE errorMessage) 指定されたステータスを使用してエラーレスポンスをクライアントに送信し、バッファをクリアします。 |
void | sendRedirect(StringSE url) 指定されたリダイレクトロケーション URL を使用して一時的なリダイレクトレスポンスをクライアントに送信し、バッファーをクリアします。 |
void | setBufferSize(int bufferSize) レスポンスの本文の優先バッファサイズを設定します。 |
void | setCharacterEncoding(StringSE characterEncoding) クライアントに送信されるレスポンスの文字エンコード(MIME 文字セット)を、たとえば UTF-8 に設定します。 |
void | setCommitted(boolean committed) |
void | setContentLength(int contentLength) レスポンス内のコンテンツ本文の長さを設定します。HTTP サーブレットでは、このメソッドは HTTP Content-Length ヘッダーを設定します。 |
void | setContentLengthLong(long contentLength) レスポンス内のコンテンツ本文の長さを設定します。HTTP サーブレットでは、このメソッドは HTTP Content-Length ヘッダーを設定します。 |
void | setContentType(StringSE contentType) レスポンスがまだコミットされていない場合、クライアントに送信されるレスポンスのコンテンツ型を設定します。 |
void | setDateHeader(StringSE name, long value) 指定された名前と日付値でレスポンスヘッダーを設定します。 |
void | setForwardedUrl(StringSE forwardedUrl) |
void | setHeader(StringSE name, StringSE value) 指定された名前と値でレスポンスヘッダーを設定します。 |
void | setIncludedUrl(StringSE includedUrl) |
void | setIntHeader(StringSE name, int value) 指定された名前と整数値でレスポンスヘッダーを設定します。 |
void | setLocale(LocaleSE locale) レスポンスがまだコミットされていない場合、レスポンスのロケールを設定します。 |
void | setOutputStreamAccessAllowed(boolean outputStreamAccessAllowed) getOutputStream() アクセスを許可するかどうかを設定します。 |
void | setStatus(int status) このレスポンスのステータスコードを設定します。 |
void | setStatus(int status, StringSE errorMessage) 使用すべきではありません。 |
void | setWriterAccessAllowed(boolean writerAccessAllowed) getWriter() アクセスを許可するかどうかを設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
getTrailerFieldsEE, setTrailerFieldsEE
public void setOutputStreamAccessAllowed(boolean outputStreamAccessAllowed)
getOutputStream()
アクセスを許可するかどうかを設定します。 デフォルトは true
です。
public boolean isOutputStreamAccessAllowed()
getOutputStream()
アクセスが許可されているかどうかを返します。public void setWriterAccessAllowed(boolean writerAccessAllowed)
getWriter()
アクセスを許可するかどうかを設定します。 デフォルトは true
です。
public boolean isWriterAccessAllowed()
getOutputStream()
アクセスが許可されているかどうかを返します。public boolean isCharset()
false
の場合、getCharacterEncoding()
はデフォルトのエンコーディング値を返します。
public void setCharacterEncoding(StringSE characterEncoding)
javax.servlet.ServletResponseEE
ServletContext.setResponseCharacterEncoding(java.lang.String)
EE、デプロイ記述子、setContentType() または setLocale() メソッドを使用してすでに設定されている場合、このメソッドで設定された値はそれらの値をオーバーライドします。text/html
の String
で ServletResponse.setContentType(java.lang.String)
EE を呼び出し、UTF-8
の String
でこのメソッドを呼び出すことは、text/html; charset=UTF-8
の String
で setContentType
を呼び出すことと同等です。 このメソッドを繰り返し呼び出して、文字エンコーディングを変更できます。getWriter
が呼び出された後、またはレスポンスがコミットされた後に呼び出された場合、このメソッドは効果がありません。
プロトコルがその方法を提供する場合、コンテナーは、サーブレットレスポンスのライターに使用される文字エンコーディングをクライアントに伝える必要があります。HTTP の場合、文字エンコードは、テキストメディア型の Content-Type
ヘッダーの一部として通信されます。サーブレットがコンテンツ型を指定しない場合、文字エンコードは HTTP ヘッダーを介して通信できないことに注意してください。ただし、サーブレットレスポンスのライターを介して書き込まれたテキストのエンコードには引き続き使用されます。
ServletResponseEE
の setCharacterEncodingEE
characterEncoding
- IANA 文字セットで定義された文字セットのみを指定する文字列 (http://www.iana.org/assignments/character-sets)ServletResponse.setContentType(java.lang.String)
EE, ServletResponse.setLocale(java.util.Locale)
EE@Nullable public StringSE getCharacterEncoding()
javax.servlet.ServletResponseEE
ServletContext.setResponseCharacterEncoding(java.lang.String)
EE、デプロイ記述子を使用)、コンテナーごと(そのコンテナーにデプロイされたすべての Web アプリケーションについて、ベンダー固有の構成を使用)の優先度の降順で、レスポンス文字エンコードを指定する次のメソッドが参照されます。結果を生成するこれらのメソッドの最初の 1 つが返されます。リクエストごとに、setCharacterEncoding
および setContentType
メソッドを使用して明示的に、または setLocale(java.util.Locale)メソッドを使用して暗黙的にレスポンスの文字セットを指定できます。明示的な指定は、暗黙的な指定よりも優先されます。getWriter
が呼び出された後、またはレスポンスがコミットされた後にこれらのメソッドを呼び出しても、文字エンコーディングには影響しません。文字エンコードが指定されていない場合、ISO-8859-1
が返されます。文字エンコードと MIME の詳細については、RFC 2047(http://www.ietf.org/rfc/rfc2047.txt) を参照してください。
ServletResponseEE
の getCharacterEncodingEE
String
、たとえば UTF-8
public ServletOutputStreamEE getOutputStream()
javax.servlet.ServletResponseEE
ServletOutputStream
EE を返します。サーブレットコンテナーはバイナリデータをエンコードしません。ServletOutputStream で flush() を呼び出すと、レスポンスがコミットされます。ServletResponse.reset()
EE が呼び出された場合を除き、このメソッドまたは ServletResponse.getWriter()
EE のいずれかを呼び出して、両方ではなく本体を書き込むことができます。
ServletResponseEE
の getOutputStreamEE
ServletOutputStream
EEServletResponse.getWriter()
EE, ServletResponse.reset()
EEpublic PrintWriterSE getWriter() throws UnsupportedEncodingExceptionSE
javax.servlet.ServletResponseEE
PrintWriter
オブジェクトを返します。PrintWriter
は、ServletResponse.getCharacterEncoding()
EE によって返される文字エンコードを使用します。getCharacterEncoding
に従って、レスポンスの文字エンコードが指定されていない場合(つまり、メソッドはデフォルト値 ISO-8859-1
を返すだけ)、getWriter
はそれを ISO-8859-1
に更新します。PrintWriter
で flush() を呼び出すと、レスポンスがコミットされます。
ServletResponse.reset()
EE が呼び出された場合を除き、このメソッドまたは ServletResponse.getOutputStream()
EE のいずれかを呼び出して、両方ではなく本体を書き込むことができます。
ServletResponseEE
の getWriterEE
PrintWriter
オブジェクト UnsupportedEncodingExceptionSE
- getCharacterEncoding
によって返された文字エンコードを使用できない場合 ServletResponse.getOutputStream()
EE, ServletResponse.setCharacterEncoding(java.lang.String)
EE, ServletResponse.reset()
EEpublic byte[] getContentAsByteArray()
public StringSE getContentAsString() throws UnsupportedEncodingExceptionSE
public void setContentLength(int contentLength)
javax.servlet.ServletResponseEE
ServletResponseEE
の setContentLengthEE
contentLength
- クライアントに返されるコンテンツの長さを指定する整数。Content-Length ヘッダーを設定します public int getContentLength()
public void setContentLengthLong(long contentLength)
javax.servlet.ServletResponseEE
ServletResponseEE
の setContentLengthLongEE
contentLength
- クライアントに返されるコンテンツの長さを指定する long; Content-Length ヘッダーを設定します public long getContentLengthLong()
public void setContentType(@Nullable StringSE contentType)
javax.servlet.ServletResponseEE
text/html;charset=UTF-8
などの文字エンコーディング仕様が含まれる場合があります。getWriter
が呼び出される前にこのメソッドが呼び出された場合、レスポンスの文字エンコードは指定されたコンテンツ型からのみ設定されます。 このメソッドは、コンテンツ型と文字エンコーディングを変更するために繰り返し呼び出される場合があります。このメソッドは、レスポンスがコミットされた後に呼び出されても効果がありません。getWriter
が呼び出された後、またはレスポンスがコミットされた後に呼び出された場合、レスポンスの文字エンコードは設定されません。
プロトコルがそうする方法を提供する場合、コンテナーはサーブレットレスポンスのライターに使用されるコンテンツ型と文字エンコーディングをクライアントに通信する必要があります。HTTP の場合、Content-Type
ヘッダーが使用されます。
ServletResponseEE
の setContentTypeEE
contentType
- コンテンツの MIME 型を指定する String
ServletResponse.setLocale(java.util.Locale)
EE, ServletResponse.setCharacterEncoding(java.lang.String)
EE, ServletResponse.getOutputStream()
EE, ServletResponse.getWriter()
EE@Nullable public StringSE getContentType()
javax.servlet.ServletResponseEE
ServletResponse.setContentType(java.lang.String)
EE を使用して適切なコンテンツ型を指定する必要があります。コンテンツ型が指定されていない場合、このメソッドは null を返します。コンテンツ型が指定されており、ServletResponse.getCharacterEncoding()
EE または ServletResponse.getWriter()
EE に従って文字エンコードが明示的または暗黙的に指定されている場合、charset パラメーターは返される文字列に含まれます。文字エンコードが指定されていない場合、charset パラメーターは省略されます。ServletResponseEE
の getContentTypeEE
text/html; charset=UTF-8
などのコンテンツ型を指定する String
または nullpublic void setBufferSize(int bufferSize)
javax.servlet.ServletResponseEE
getBufferSize
を使用して見つけることができます。バッファを大きくすると、実際に何かが送信される前により多くのコンテンツを書き込むことができるため、サーブレットに適切なステータスコードとヘッダーを設定する時間をより多く提供できます。バッファを小さくすると、サーバーのメモリ負荷が減少し、クライアントがデータをより早く受信できるようになります。
このメソッドは、レスポンス本文のコンテンツが書き込まれる前に呼び出す必要があります。コンテンツが書き込まれた場合、またはレスポンスオブジェクトがコミットされた場合、このメソッドは IllegalStateException
をスローします。
ServletResponseEE
の setBufferSizeEE
bufferSize
- 優先バッファサイズ ServletResponse.getBufferSize()
EE, ServletResponse.flushBuffer()
EE, ServletResponse.isCommitted()
EE, ServletResponse.reset()
EEpublic int getBufferSize()
javax.servlet.ServletResponseEE
ServletResponseEE
の getBufferSizeEE
ServletResponse.setBufferSize(int)
EE, ServletResponse.flushBuffer()
EE, ServletResponse.isCommitted()
EE, ServletResponse.reset()
EEpublic void flushBuffer()
javax.servlet.ServletResponseEE
public void resetBuffer()
javax.servlet.ServletResponseEE
IllegalStateException
をスローします。public void setCommitted(boolean committed)
public boolean isCommitted()
javax.servlet.ServletResponseEE
ServletResponseEE
の isCommittedEE
ServletResponse.setBufferSize(int)
EE, ServletResponse.getBufferSize()
EE, ServletResponse.flushBuffer()
EE, ServletResponse.reset()
EEpublic void reset()
javax.servlet.ServletResponseEE
ServletResponse.getWriter()
EE または ServletResponse.getOutputStream()
EE の呼び出し状態もクリアされます。たとえば、ServletResponse.getWriter()
EE、ServletResponse.reset()
EE、ServletResponse.getOutputStream()
EE を呼び出すことは正当です。このメソッドの前に ServletResponse.getWriter()
EE または ServletResponse.getOutputStream()
EE が呼び出された場合、対応する返された Writer または OutputStream が停止し、古いオブジェクトを使用する動作は未定義になります。レスポンスがコミットされている場合、このメソッドは IllegalStateException
をスローします。public void setLocale(LocaleSE locale)
javax.servlet.ServletResponseEE
ServletResponse.setContentType(java.lang.String)
EE または ServletResponse.setCharacterEncoding(java.lang.String)
EE を使用して文字エンコーディングが明示的に設定されておらず、getWriter
がまだ呼び出されておらず、レスポンスがまだコミットされていない場合、ロケールのレスポンスに適切に文字エンコーディングを設定します。デプロイ記述子に locale-encoding-mapping-list
要素が含まれ、その要素が指定されたロケールのマッピングを提供する場合、そのマッピングが使用されます。それ以外の場合、ロケールから文字エンコーディングへのマッピングはコンテナーに依存します。 このメソッドは、ロケールと文字エンコーディングを変更するために繰り返し呼び出される場合があります。レスポンスがコミットされた後に呼び出された場合、メソッドは効果がありません。ServletResponse.setContentType(java.lang.String)
EE が文字セット指定で呼び出された後、ServletResponse.setCharacterEncoding(java.lang.String)
EE が呼び出された後、getWriter
が呼び出された後、レスポンスがコミットされた後に呼び出された場合、レスポンスの文字エンコードは設定されません。
プロトコルがその方法を提供する場合、コンテナーは、サーブレットレスポンスのライタに使用されるロケールと文字エンコーディングをクライアントに伝える必要があります。HTTP の場合、ロケールは、Content-Language
ヘッダー、テキストメディア型の Content-Type
ヘッダーの一部としての文字エンコードを介して通信されます。サーブレットがコンテンツ型を指定しない場合、文字エンコードは HTTP ヘッダーを介して通信できないことに注意してください。ただし、サーブレットレスポンスのライターを介して書き込まれたテキストのエンコードには引き続き使用されます。
ServletResponseEE
の setLocaleEE
locale
- レスポンスのロケール ServletResponse.getLocale()
EE, ServletResponse.setContentType(java.lang.String)
EE, ServletResponse.setCharacterEncoding(java.lang.String)
EEpublic LocaleSE getLocale()
javax.servlet.ServletResponseEE
ServletResponse.setLocale(java.util.Locale)
EE メソッドを使用して、このレスポンスに指定されたロケールを返します。レスポンスのコミット後に setLocale
を呼び出しても効果はありません。ロケールが指定されていない場合、コンテナーのデフォルトのロケールが返されます。ServletResponseEE
の getLocaleEE
ServletResponse.setLocale(java.util.Locale)
EEpublic void addCookie(CookieEE cookie)
javax.servlet.http.HttpServletResponseEE
HttpServletResponseEE
の addCookieEE
cookie
- Cookie をクライアントに返す public CookieEE[] getCookies()
public boolean containsHeader(StringSE name)
javax.servlet.http.HttpServletResponseEE
HttpServletResponseEE
の containsHeaderEE
name
- ヘッダー名 true
。それ以外の場合は false
public CollectionSE<StringSE> getHeaderNames()
Servlet 3.0 以降、このメソッドは HttpServletResponse でも定義されます。
HttpServletResponseEE
の getHeaderNamesEE
Strings
の Set
、ない場合は空の Set
@Nullable public StringSE getHeader(StringSE name)
Servlet 3.0 以降、このメソッドは HttpServletResponse でも定義されています。Spring 3.1 以降、Servlet 3.0 との互換性のために文字列化された値を返します。生のオブジェクトアクセスには getHeaderValue(String)
の使用を検討してください。
HttpServletResponseEE
の getHeaderEE
name
- ヘッダーの名前 null
public ListSE<StringSE> getHeaders(StringSE name)
Servlet 3.0 以降、このメソッドは HttpServletResponse でも定義されています。Spring 3.1 以降、Servlet 3.0 との互換性のために文字列化された値のリストを返します。生のオブジェクトアクセスには getHeaderValues(String)
の使用を検討してください。
HttpServletResponseEE
の getHeadersEE
name
- ヘッダーの名前 @Nullable public ObjectSE getHeaderValue(StringSE name)
複数の値の場合、最初の値を返します。
name
- ヘッダーの名前 null
public ListSE<ObjectSE> getHeaderValues(StringSE name)
name
- ヘッダーの名前 public StringSE encodeURL(StringSE url)
サブクラスでオーバーライドでき、セッション ID などを追加します。
HttpServletResponseEE
の encodeURLEE
url
- エンコードされる URL。public StringSE encodeRedirectURL(StringSE url)
encodeURL(java.lang.String)
に委譲し、指定された URL 文字列をそのまま返します。 サブクラスでオーバーライドでき、リダイレクト固有の方法でセッション ID などを追加できます。一般的な URL エンコーディングルールについては、代わりに一般的な encodeURL(java.lang.String)
メソッドをオーバーライドし、一般的な URL だけでなくリダイレクト URL にも適用します。
HttpServletResponseEE
の encodeRedirectURLEE
url
- エンコードされる URL。HttpServletResponse.sendRedirect(java.lang.String)
EE, HttpServletResponse.encodeUrl(java.lang.String)
EE@DeprecatedSE public StringSE encodeUrl(StringSE url)
HttpServletResponseEE
の encodeUrlEE
url
- エンコードされる URL。@DeprecatedSE public StringSE encodeRedirectUrl(StringSE url)
HttpServletResponseEE
の encodeRedirectUrlEE
url
- エンコードされる URL。public void sendError(int status, StringSE errorMessage) throws IOExceptionSE
javax.servlet.http.HttpServletResponseEE
指定されたステータスを使用してクライアントにエラーレスポンスを送信し、バッファをクリアします。サーバーはデフォルトで、指定されたメッセージを含む HTML 形式のサーバーエラーページのように見えるレスポンスを作成し、コンテンツ型を "text/html" に設定します。呼び出し元は、現在のレスポンスのエンコードとコンテンツ型に関して安全であることを確認するために、メッセージをエスケープまたは再エンコードする責任を負いません。安全性のこの側面は、メッセージを含むエラーページを生成するため、コンテナーの責任です。サーバーは Cookie を保持し、エラーページを有効なレスポンスとして提供するために必要なヘッダーをクリアまたは更新する場合があります。
渡されたステータスコードに対応する Web アプリケーションのエラーページ宣言が行われた場合、提案された msg パラメーターよりも優先して返され、msg パラメーターは無視されます。
レスポンスがすでにコミットされている場合、このメソッドは IllegalStateException をスローします。このメソッドを使用した後、レスポンスはコミットされたと見なされるべきであり、書き込まれるべきではありません。
HttpServletResponseEE
の sendErrorEE
status
- エラー状態コード errorMessage
- 説明的なメッセージ IOExceptionSE
- 入力または出力の例外が発生した場合 public void sendError(int status) throws IOExceptionSE
javax.servlet.http.HttpServletResponseEE
レスポンスがすでにコミットされている場合、このメソッドは IllegalStateException をスローします。このメソッドを使用した後、レスポンスはコミットされたと見なされるべきであり、書き込まれるべきではありません。
HttpServletResponseEE
の sendErrorEE
status
- エラー状態コード IOExceptionSE
- 入力または出力の例外が発生した場合 public void sendRedirect(StringSE url) throws IOExceptionSE
javax.servlet.http.HttpServletResponseEE
HttpServletResponse.SC_FOUND
EE 302(Found)に設定されます。このメソッドは相対 URL を受け入れることができます。サーブレットコンテナーは、レスポンスをクライアントに送信する前に相対 URL を絶対 URL に変換する必要があります。場所が先頭に "/" のない相対的な場所である場合、コンテナーは現在のリクエスト URI に相対的であると解釈します。ロケーションが先頭に "/" を付けた相対位置である場合、コンテナーはサーブレットコンテナールートに対する相対位置として解釈します。場所が 2 つの先頭 "/" で相対的な場合、コンテナーはそれをネットワークパス参照として解釈します(RFC 3986: ユニフォームリソース識別子 (URI): 汎用構文のセクション 4.2「相対参照」を参照)。レスポンスがすでにコミットされている場合、このメソッドは IllegalStateException をスローします。このメソッドを使用した後、レスポンスはコミットされたと見なされるべきであり、書き込まれるべきではありません。
HttpServletResponseEE
の sendRedirectEE
url
- リダイレクト場所の URLIOExceptionSE
- 入力または出力の例外が発生した場合 public void setDateHeader(StringSE name, long value)
javax.servlet.http.HttpServletResponseEE
containsHeader
メソッドは、値を設定する前にヘッダーの存在をテストするために使用できます。HttpServletResponseEE
の setDateHeaderEE
name
- 設定するヘッダーの名前 value
- 割り当てられた日付値 HttpServletResponse.containsHeader(java.lang.String)
EE, HttpServletResponse.addDateHeader(java.lang.String, long)
EEpublic void addDateHeader(StringSE name, long value)
javax.servlet.http.HttpServletResponseEE
HttpServletResponseEE
の addDateHeaderEE
name
- 設定するヘッダーの名前 value
- 追加の日付値 HttpServletResponse.setDateHeader(java.lang.String, long)
EEpublic long getDateHeader(StringSE name)
public void setHeader(StringSE name, StringSE value)
javax.servlet.http.HttpServletResponseEE
containsHeader
メソッドは、値を設定する前にヘッダーの存在をテストするために使用できます。HttpServletResponseEE
の setHeaderEE
name
- ヘッダーの名前 value
- ヘッダー値にオクテット文字列が含まれる場合、RFC 2047 に従ってエンコードする必要があります (http://www.ietf.org/rfc/rfc2047.txt)HttpServletResponse.containsHeader(java.lang.String)
EE, HttpServletResponse.addHeader(java.lang.String, java.lang.String)
EEpublic void addHeader(StringSE name, StringSE value)
javax.servlet.http.HttpServletResponseEE
HttpServletResponseEE
の addHeaderEE
name
- ヘッダーの名前 value
- 追加のヘッダー値オクテット文字列を含む場合、RFC 2047 に従ってエンコードする必要があります (http://www.ietf.org/rfc/rfc2047.txt)HttpServletResponse.setHeader(java.lang.String, java.lang.String)
EEpublic void setIntHeader(StringSE name, int value)
javax.servlet.http.HttpServletResponseEE
containsHeader
メソッドは、値を設定する前にヘッダーの存在をテストするために使用できます。HttpServletResponseEE
の setIntHeaderEE
name
- ヘッダーの名前 value
- 割り当てられた整数値 HttpServletResponse.containsHeader(java.lang.String)
EE, HttpServletResponse.addIntHeader(java.lang.String, int)
EEpublic void addIntHeader(StringSE name, int value)
javax.servlet.http.HttpServletResponseEE
HttpServletResponseEE
の addIntHeaderEE
name
- ヘッダーの名前 value
- 割り当てられた整数値 HttpServletResponse.setIntHeader(java.lang.String, int)
EEpublic void setStatus(int status)
javax.servlet.http.HttpServletResponseEE
このメソッドは、エラーがない場合(たとえば、SC_OK または SC_MOVED_TEMPORARILY ステータスコード)に戻りステータスコードを設定するために使用されます。
このメソッドを使用してエラーコードを設定すると、コンテナーのエラーページメカニズムはトリガーされません。エラーが発生し、呼び出し元が Web アプリケーションで定義されたエラーページを呼び出す場合は、代わりに HttpServletResponse.sendError(int, java.lang.String)
EE を使用する必要があります。
このメソッドは、Cookie およびその他のレスポンスヘッダーを保持します。
有効なステータスコードは、2XX、3XX、4XX、5XX の範囲のものです。他のステータスコードは、コンテナー固有として扱われます。
HttpServletResponseEE
の setStatusEE
status
- ステータスコード HttpServletResponse.sendError(int, java.lang.String)
EE@DeprecatedSE public void setStatus(int status, StringSE errorMessage)
HttpServletResponseEE
の setStatusEE
status
- ステータスコード errorMessage
- ステータスメッセージ public int getStatus()
javax.servlet.http.HttpServletResponseEE
HttpServletResponseEE
の getStatusEE
public void addIncludedUrl(StringSE includedUrl)