public class AuthenticationControlFilter extends AbstractControlFilter<AuthenticationController>
このクラスではブラウザからのリクエストに対するフィルタ処理を、
Bean定義ファイルで指定された任意のAuthenticationController
インスタンスにログオン済みかどうかのチェック処理を委譲する。
ログオンが必要なパスへのアクセスがあった場合は、 ユーザがログオン済みか
どうかを判別し、ログオン済みではなかった場合、
UnauthenticatedException
をスローする。
この機能を使用するには デプロイメントディスクリプタ(web.xml)と
Bean定義ファイルに以下のように設定する。
このとき、Bean定義ファイルに定義するid属性が、
sampleAuthenticationControllerである<bean>要素の
class属性には、AuthenticationController
インタフェースを
実装したクラスを設定する。
<filter>
<filter-name>
authenticationControlFilter
</filter-name>
<filter-class>
jp.terasoluna.fw.web.thin.AuthenticationControlFilter
</filter-class>
<init-param>
<param-name>controller</param-name>
<param-value>
"sampleAuthenticationController"
</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>authenticationControlFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<error-page>
<exception-type>
jp.terasoluna.fw.web.thin.UnauthenticationException
</exception-type>
<location>/unauthenticatedError.jsp</location>
</error-page>
Bean定義ファイル
<bean id="sampleAuthenticationController"
class="jp.terasoluna…SampleAuthenticationController"/>
なお、Bean定義ファイルに定義する<bean>要素のid属性をデフォルト値である
"authenticationController"に設定する場合には、デプロイメントディスクリプタ
(web.xml)内の<filter>要素から<init-param>要素を省略することが
できる。修飾子とタイプ | フィールドと説明 |
---|---|
static String |
AUTHENTICATION_THRU_KEY
リクエストがフィルタを通過したことを示すリクエスト属性のキー。
|
protected static AuthenticationController |
controller
AuthenticationControllerインスタンス。
|
static String |
DEFAULT_AUTHENTICATION_BEAN_ID
DIコンテナからコントローラーの実装クラスを取得するための
<bean>要素のid属性に使用されるデフォルトid。
|
config
コンストラクタと説明 |
---|
AuthenticationControlFilter() |
修飾子とタイプ | メソッドと説明 |
---|---|
void |
doFilter(javax.servlet.ServletRequest req,
javax.servlet.ServletResponse res,
javax.servlet.FilterChain chain)
ログオン済みチェックを行う。
|
static AuthenticationController |
getAuthenticationController()
AuthenticationControllerインスタンスを戻す。
|
protected Class |
getControllerClass()
アクセス制御を行うクラスが実装すべきインタフェースを返す。
|
String |
getDefaultControllerBeanId()
DIコンテナからコントローラを取得する際のデフォルトのidを返す。
|
protected String |
getErrorCode()
コントローラの生成失敗を示すエラーコードを返す。
|
void |
init(javax.servlet.FilterConfig config)
フィルタがサービス開始状態になる際に、コンテナによって呼び出される。
|
destroy, getController, setConfig
public static final String AUTHENTICATION_THRU_KEY
public static final String DEFAULT_AUTHENTICATION_BEAN_ID
protected static AuthenticationController controller
public static AuthenticationController getAuthenticationController()
public void init(javax.servlet.FilterConfig config) throws javax.servlet.ServletException
init
インタフェース内 javax.servlet.Filter
init
クラス内 AbstractControlFilter<AuthenticationController>
config
- FilterConfigインスタンス。javax.servlet.ServletException
- 初期化異常時にスローされる例外。Filter.init(javax.servlet.FilterConfig)
,
AbstractControlFilter
public void doFilter(javax.servlet.ServletRequest req, javax.servlet.ServletResponse res, javax.servlet.FilterChain chain) throws IOException, javax.servlet.ServletException
doFilter
インタフェース内 javax.servlet.Filter
doFilter
クラス内 AbstractControlFilter<AuthenticationController>
req
- HTTPリクエストres
- HTTPレスポンスchain
- フィルタチェーンIOException
- I/Oエラーjavax.servlet.ServletException
- サーブレット例外Filter.doFilter(javax.servlet.ServletRequest,
javax.servlet.ServletResponse,
javax.servlet.FilterChain)
protected Class getControllerClass()
getControllerClass
クラス内 AbstractControlFilter<AuthenticationController>
protected String getErrorCode()
getErrorCode
クラス内 AbstractControlFilter<AuthenticationController>
public String getDefaultControllerBeanId()
getDefaultControllerBeanId
クラス内 AbstractControlFilter<AuthenticationController>
Copyright © 2016. All Rights Reserved.