# パッケージ org.opengion.hayabusa.common

package org.opengion.hayabusa.common

     はやぶさ共通のクラスを提供します。

    共通クラスフレームワークを利用する上でシステムリソースにアクセスしたり、
     例外（Exception）を加工したり、ログを制御したりする共通的に利用するクラス群です。
     このパッケージのクラスは、他のパッケージから独立しています。

- Related Packages
  パッケージ
  説明
  org.opengion.hayabusa
  このドキュメントは、Ｗｅｂアプリケーションフレームワーク『はやぶさ』の ＡＰＩ 仕様です。
- クラス
  説明
  HybsContextListener
  ServletContextListener を実装した､ｺﾝﾃｷｽﾄの監視ｵﾌﾞｼﾞｪｸﾄです｡ これは､ｺﾝﾃｷｽﾄ(Webｱﾌﾟﾘｹｰｼｮﾝ)の起動/ｼｬｯﾄﾀﾞｳﾝを監視できる｡ ServletContextListener は､ ConnectionFactory のｺﾈｸｼｮﾝﾌﾟｰﾙへのｱｸｾｽ／開放 ResourceFactory のﾘｿｰｽ情報へのｱｸｾｽ／開放 の作業を行います｡ このﾘｽﾅｰは､WEB-INF/web.xml で､組み込みます｡ 【WEB-INF/web.xml】 <listener> <listener-class> org.opengion.hayabusa.common.HybsContextListener </listener-class> </listener>
  HybsOverflowException
  有効件数が オーバーフローした場合に 発生させる RuntimeException のサブクラスです。
  HybsSessionListener
  HttpSessionListener を実装した、セッション状態の監視リスナークラスです。
  HybsSystem
  共通的に、使用されるシステム関連メソッドを集約したクラスです。
  HybsSystemException
  共通的に使用されるエクセプションクラスです。
  SystemData
  ﾘｿｰｽﾌｧｲﾙの代わりとなるｼｽﾃﾑﾊﾟﾗﾒｰﾀをｸﾗｽ化したﾃﾞｰﾀｸﾗｽです｡ それぞれの設定値は､ﾃﾞｰﾀﾍﾞｰｽにｺﾒﾝﾄとともに設定されます｡ そのとき､og.paramLevel ﾀｸﾞにより､属性を設定しています｡ 0:設定必須 1:設定確認 2:使用時設定 3:標準推奨 4:個人設定可 5:追加設定 7:要再起動 8:設定不可 9:自動設定 og.cryptography ﾀｸﾞは､指定の属性値を暗号化するかどうかを指定します｡ 暗号化は､org.opengion.hayabusa.security.HybsCryptography ｸﾗｽで行います｡将来的な拡張機能として､ 各ｼｽﾃﾑ毎に暗号化ｷｰを変えることで､ｾｷｭﾘﾃｨ強化が可能です｡ ｴﾝｼﾞﾝﾊﾟﾗﾒｰﾀﾃﾞｰﾀは､ｴﾝｼﾞﾝとともに配布されるﾏｽﾀﾃﾞｰﾀになります｡ よって､配布形式はどのような形でもよく､今回は､JavaDoc にて各ﾊﾟﾗﾒｰﾀの 意味やﾃﾞﾌｫﾙﾄ設定値が判断できるように､ｸﾗｽの public static final 変数として 定義しました｡ 従来は､resource.ｼｽﾃﾑﾊﾟﾗﾒｰﾀ の一般設定用の ｼｽﾃﾑﾊﾟﾗﾒｰﾀ ﾌｧｲﾙと ｴﾝｼﾞﾝ内部で持っている org/opengion/hayabusa/resource/properties の ｼｽﾃﾑﾊﾟﾗﾒｰﾀ ﾌｧｲﾙにより維持されていましたが､ｴﾝｼﾞﾝﾊﾟﾗﾒｰﾀ 定義ﾃｰﾌﾞﾙ(GE12)と､commom/SystemData.java ｸﾗｽによる管理に 変更されました｡ ｼｽﾃﾑﾊﾟﾗﾒｰﾀは､ＤＢへのｱｸｾｽを決定するため､初期設定値を定義する必要があります｡ これは､､ｱﾌﾟﾘｹｰｼｮﾝ･ﾃﾞｨｽｸﾘﾌﾟﾀ(WEB-INF/web.xml)に､context-param として､ ｷｰと値のｾｯﾄで､初期ｱｸｾｽ用の情報を渡します｡ ｼｽﾃﾑﾊﾟﾗﾒｰﾀ定義ﾃｰﾌﾞﾙ(GE12)には､SYSTEM_IDとして､通常のｼｽﾃﾑIDと､ ｴﾝｼﾞﾝﾊﾟﾗﾒｰﾀがあります｡ｴﾝｼﾞﾝﾊﾟﾗﾒｰﾀは､SYSTEM_ID='**'として､登録 されています｡ SystemData ｸﾗｽのﾌｨｰﾙﾄﾞは､その記述した順番でｾｯﾄしますので､ 設定順(ﾌｨｰﾙﾄﾞの記述順)を考慮する必要があります｡ また､ﾃﾞｰﾀﾍﾞｰｽへの登録は､このｸﾗｽをJavaDocのｶｽﾀﾑﾄﾞｯｸﾚｯﾄにより 一旦 XML ﾌｧｲﾙに変換後､ｵﾗｸﾙXDK形式のXMLﾌｧｲﾙにXSLTで変換し､ このﾊﾟｯｹｰｼﾞ(org.opengion.hayabusa.common)に配置します｡ このﾃﾞｰﾀの変換時にｺﾒﾝﾄ情報を付加したXMLﾌｧｲﾙを作成し､DB登録(GE12)しますので､ このﾃﾞｰﾀを参考に､ｼｽﾃﾑ個別に書き換えを行えます｡
  SystemInstaller
  システムの自動インストールと自動更新を行います。
  SystemManager
  Webアプリケーション全体で使用しているオブジェクト類のトータルの管理クラスです。
  SystemParameter
  ログインしたサーブレットコンテキストに対応したシステムパラメータデータを取得するクラスです。
  UserSummary
  ユーザー情報(UserInfo)のサマリー情報のみハンドリングする為のインターフェースです。