shohaku.shoin.bundle
クラス XMLResourceBundle

java.lang.Object
  shohaku.shoin.XResourceBundle
      shohaku.shoin.bundle.AbstractGinkgoXResourceBundle
          shohaku.shoin.bundle.XMLResourceBundle

すべての実装インタフェース:

ResourceSet

public class XMLResourceBundle

extends AbstractGinkgoXResourceBundle

XMLProperties を用いた階層化リソースバンドルを提供します。

XMLリソースバンドル固有の名前規約

XMLリソースバンドルには唯一 java.util.ResourceBundle とは別の名前規約が有ります。
XMLリソースバンドルでは基底名を基にして複数のファイルが読取の対象となるため、同一の基底名に属すファイルは同一の解析ルールが摘要される必要があります。
よって基底名単位で解析ルールを指定する為の以下の配置規約が定義されています。

• 基底名単位で解析ルールを指定する場合のファイル名は '基底名 + _rule.xml' で指定します。

上記位置に配置しておけばシステムが自動で読み取ります, 配置されていなければデフォルトが使用されます。

XMLリソースバンドル固有の問題

このバンドルは複数のデータ型に対応する一方で、 java.util.ResourceBundle と同様に上位階層から値が継承されるモデルを採用しています。
そのため上位階層で定義される型とは、交換性の無い型で、下位の階層が同一名のプロパティを定義する事が可能です。
この特徴はデータ型の管理を難しくする可能性があります。
この特徴を踏まえて、データ型の設計および管理を行うことが推奨されます。

フィールドの概要

クラス shohaku.shoin.XResourceBundle から継承したフィールド

bundleBase, lookup, parent

メソッドの概要

static XMLResourceBundle	getBundle(java.lang.String baseName, XResourceBundleBase bundleBase) 指定された基底名、束縛基準、および呼び出し側のクラスローダを使用して、リソースバンドルを取得します。
static XMLResourceBundle	getBundle(java.lang.String baseName, XResourceBundleBase bundleBase, shohaku.core.resource.IOResourceLoader irLoader, java.lang.ClassLoader classLoader) 指定された基底名、束縛基準、クラスローダを使用して、拡張リソースバンドルを取得します。

クラス shohaku.shoin.bundle.AbstractGinkgoXResourceBundle から継承したメソッド

getDocument

クラス shohaku.shoin.XResourceBundle から継承したメソッド

containsKey, getKeys, getMapView, getObject, getObject, size

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getBundle

public static XMLResourceBundle getBundle(java.lang.String baseName,
                                          XResourceBundleBase bundleBase)

指定された基底名、束縛基準、および呼び出し側のクラスローダを使用して、リソースバンドルを取得します。
このメソッドを呼び出すことは、以下を呼び出すことと同じです。
getBundle(baseName, locale, getDefaultLoader())

パラメータ:

baseName - 基底名

bundleBase - 束縛基準

戻り値:

指定された基底名と束縛基準の拡張リソースバンドル

例外:

java.util.MissingResourceException - 指定された基底名のリソースバンドルが見つからない場合

getBundle

public static XMLResourceBundle getBundle(java.lang.String baseName,
                                          XResourceBundleBase bundleBase,
                                          shohaku.core.resource.IOResourceLoader irLoader,
                                          java.lang.ClassLoader classLoader)

指定された基底名、束縛基準、クラスローダを使用して、拡張リソースバンドルを取得します。

パラメータ:

baseName - 基底名

bundleBase - 束縛基準

irLoader - IOリソース生成機能

classLoader - クラスローダ

戻り値:

指定された基底名と束縛基準の拡張リソースバンドル

例外:

java.util.MissingResourceException - 指定された基底名のリソースバンドルが見つからない場合