> BEA Workshop 10.2 マルチバイト環境での使用にあたって
     前  次    目次を新しいウィンドウで開く     
内容の開始点

BEA Workshop 10.2 マルチバイト環境での使用にあたって

本書は以下より構成されます。

 

BEA Workshop 10.2 ランゲージパック のバンドル製品

BEA Workshop 10.2 には、以下の Eclipse および Plug-in 製品がバンドルされています。

BEA Workshop 10.2 ランゲージパックには、上記モジュールに対応するリリース時の最新版である以下の Eclipse および Plug-in 製品の言語パックがバンドルされています。

 

デプロイメント記述子のエンコーディング設定

Enterprise Application Project を作成時 weblogic-application.xml には、以下のようにデフォルトで UTF-8 が設定されます。


        <application-param>

        <param-name>webapp.encoding.default</param-name>

              <param-value>UTF-8</param-value>

        </application-param>

 

Web Project を作成時には web.xml や weblogic.xml にはエンコーディングの設定がされません。これは Web Project レベルでの自動設定が Enterprise Application Project レベルでの設定を上書きしてしまうことを回避するためです。Web Project レベルでの設定が必要な場合には、下記の設定例のように Workshop 上でこれらのファイルを編集する必要があります。設定方法、設定の影響範囲等の詳細は、WebLogic Server のマルチバイト環境での使用にあたっておよび WebLogic Server のマニュアルを参照してください。

web.xml の page-encoding 要素:


          <jsp-config>

            <jsp-property-group>

              <url-pattern>/euc/*</url-pattern>

              <page-encoding>EUC-JP</page-encoding>

            </jsp-property-group>

            <jsp-property-group>

              <url-pattern>/utf8/*</url-pattern>

              <page-encoding>UTF-8</page-encoding>

            </jsp-property-group>

          </jsp-config>

 

weblogic.xml の input-charset 要素:


          <charset-params>

            <input-charset>

              <resource-path>/*</resource-path>

              <java-charset-name>EUC_JP</java-charset-name>

            </input-charset>

            <input-charset>

              <resource-path>/rus/joe/*</resource-path>

              <java-charset-name>Shift_JIS</java-charset-name>

            </input-charset>

          </charset-params>

 

ファイル作成時のデフォルトのエンコーディング

Workshop ではファイル作成時以下のエンコーディングがデフォルトで使用されます。

ファイルの種類
説明
JSP ファイル
(NetUI/JSF)
デフォルト エンコーディング: UTF-8
デフォルト エンコーディングの変更: 不可
ファイル作成後に個々に変更する必要があります。
JSP ファイル
(上記以外)
デフォルト エンコーディング: Java VM エンコーディング
デフォルト エンコーディングの変更: 可
Window > Preferences > Web and XML > JSP Files (Creating Files) で変更可能Linux 上の ja_JP.eucjp など一部の Locale では VM エンコーディングが正しく設定されない場合があります。その場合には Workspace 作成後、Window > Preferences > Web and XML > JSP Files (Creating Files) のエンコーディングを手動で変更してください。
XML ファイル
デフォルト エンコーディング: UTF-8
デフォルト エンコーディングの変更: 可
Window > Preferences > Web and XML > XML Files (Creating Files) で変更可能
自動生成時のエンコーディング: UTF-8
内部で自動的に生成されるファイルでエンコーディングの変更およびファイルの修正はできません。
HTML ファイル
デフォルト エンコーディング: Java VM エンコーディング
WebLogic Workshop 8.1 ではデフォルトは UTF-8 でしたが、Workshop 9.2 以降、Web Tool Platform の作成 Wizard の採用により、Java の VM エンコーディングに変更になりました。
デフォルト エンコーディングの変更: 可
Window > Preferences > Web and XML > HTML Files (Creating Files) で変更可能。
Linux 上の ja_JP.eucjp など一部の Locale では VM エンコーディングが正しく設定されない場合があります。その場合には Workspace 作成後、Window > Preferences > Web and XML > HTML Files (Creating Files) のエンコーディングを手動で変更してください。
CSS ファイル
デフォルト エンコーディング: Java VM エンコーディング
デフォルト エンコーディングの変更: 可
Window > Preferences > Web and XML > CSS Files (Creating Files) で変更可能。
Linux 上の ja_JP.eucjp など一部の Locale では VM エンコーディングが正しく設定されない場合があります。その場合には Workspace 作成後、Window > Preferences > Web and XML > CSS Files (Creating Files) のエンコーディングを手動で変更してください。
Java ファイル
デフォルト エンコーディング: Java VM エンコーディング
デフォルト エンコーディングの変更: 不可
Workshop では Eclipse の Content Types での java 拡張子のエンコーディングを VMエンコーディングから変更することはできません。
但し、Linux 上で ja_JP.eucjp Locale を使用する場合に限り、Workspace 作成後、 Window > Preferences > General > Content Types > Text > Java Source File にてデフォルトエンコーディングに ‘EUC-JP’ を設定する必要があります。
自動生成時のエンコーディング: Java VM エンコーディング
内部で自動的に生成されるファイルでエンコーディングの変更およびファイルの修正はできません。
JavaScript ファイル
デフォルト エンコーディング: ISO-8859-1
デフォルト エンコーディングの変更: 可
Window > Preferences > General > Content Types > Text > JavaScript で変更可能

注意： Java Script ファイルに関しては、マルチバイトを使用する場合には必ずエンコーディングの設定を変更する必要があります。

 

ファイル保存、読み込み時のエンコーディング指定

Workshop ではファイル保存時および読み込み時に以下の設定箇所によりエンコーディングが決定されます。下記設定のほかに Eclipse 上 において、File > Properties > Info > text file encoding をファイルもしくはフォルダ単位で設定することが可能であり、これが最優先されてエンコーディングが決定されますが、これは Workspace 内でのみ有効なエンコーディング指定となります。下記表にも Workspace 内でのみ有効なエンコーディング指定(ContentTypes等)がありますが、アプリケーションが正常に実行されるためには、実行時に採用されるエンコーディングと実際のファイルエンコーディングが一致している必要があります。ファイルの移植性を保つためにも、ファイル毎もしくはWeb Project単位(JSP の場合)に明示的にエンコーディング指定をすることをお勧めします。

JSP ファイル

設定箇所
有効範囲
優先度
設定例
web.xml の page-encoding 要素
Web Project毎
1*1*2
<jsp-config>
  <jsp-property-group>
    <url-pattern>/euc/*</url-pattern>
    <page-encoding>EUC-JP</page-encoding>
  </jsp-property-group>
  <jsp-property-group>
    <url-pattern>/utf8/*</url-pattern>
    <page-encoding>UTF-8</page-encoding>
  </jsp-property-group>
</jsp-config
page ディレクティブの pageEncoding 属性
ファイル毎
1*1*2
<%@ page pageEncoding="Windows-31J" %>
page ディレクティブの contentType 属性
ファイル毎
2*2
<%@ page contentType="text/html; charset=EUC-JP" %>
Window > Preferences > General > Content Types > Text > JSP
Workspace 毎
3
ISO-8859-1

*1 JSP2.0 の仕様により、web.xml の page-encoding 要素と page ディレクティブの pageEncoding 属性が異なると、翻訳時にエラーとなります。そのため web.xml の page-encoding 要素の値を設定した場合には、page ディレクティブの pageEncoding 属性と一致させる必要があります。

*2 ファイル中にMeta タグの charset属性を含む場合、優先されるエンコーディングと一致させる必要があります。

 

JSP Document ファイル

設定箇所
有効範囲
優先度
設定例
XML 宣言の encoding 属性
ファイル毎
1*1
<?xml version="1.0" encoding="UTF-8"?>

*1 JSP Document は、XML として記述されるので、JSP Document ファイルのエンコーディング指定は XML の仕様に準拠します。Workshop ではこの指定を省略することはできません。なお、JSP2.0 の仕様により、JSP Document において、web.xml の page-encoding 要素や page ディレクティブの pageEncoding 属性によるファイル エンコーディングの設定をした場合、これらが JSP Document の XML 宣言の encoding 属性と矛盾していると、翻訳時にエラーとなります。

 

Tag ファイル

設定箇所
有効範囲
優先度
設定例
tag ディレクティブの pageEncoding 属性
ファイル 毎
1*1
<%@ tag pageEncoding="EUC-JP" %>

*1 Workshopでは、この指定を省略することはできません。

 

XML 形式 Tag ファイル

設定箇所
有効範囲
優先度
設定例
XML 宣言の encoding 属性
ファイル毎
1*1
<?xml version='1.0' encoding='UTF-8' ?>
Window > Preferences > General > Content Types > Text > JSP > JSP Tag Definition*2
Workspace 毎
2
UTF-8

*1 XML 形式 Tag ファイルは、XML として記述されるので、XML 形式 Tag ファイルのエンコーディング指定は XML の仕様に準拠します。また JSP2.0 の仕様により、XML 形式 Tag ファイルに pageEncoding 属性によるエンコーディング指定は認められていないため、設定することはできません。

 

HTML ファイル

設定箇所
有効範囲
優先度
設定例
META タグの content の charset 属性
ファイル毎
1
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
Window > Preferences > General > Content Types > Text > HTML*1
Workspace 毎
2
ISO-2022-JP
Window > Preferences > Web and XML > HTML Files (Loading Files)*2
Workspace 毎
3
EUC-JP

*1 拡張子のデフォルト値として UTF-8 を設定することはできません。UTF-8 を使用する場合には、META タグで指定してください。
*2 ロード ファイルのデフォルト値として UTF-8 を設定することはできません。UTF-8 を使用する場合には、META タグで指定してください。

 

XML ファイル

設定箇所
有効範囲
優先度
設定例
XML 宣言の encoding 属性
ファイル毎
1
<?xml version='1.0' encoding='utf-8' ?>
Window > Preferences > General > Content Types > Text > XML
Workspace 毎
2
UTF-8

 

CSS ファイル

設定箇所
有効範囲
優先度
設定例
@CHARSET 属性
ファイル毎
1*1
@CHARSET “EUC-JP”;

*1 現バージョンの Eclipse では、この指定を省略することはできません。


  ページの先頭       前  次