JBuilder 4

リリース情報

この文書には JBuilder 4 の確認されている問題点や回避策などの重要な注意事項が含まれています。

最新情報


目次

全般
インストール
Enterprise JavaBeans(EJB)
Web 開発
チーム開発
エディタ
コンポーネント
デバッガ
デザイナ
データベースと JDataStore
ウィザード
実行時
ヘルプビューア
OpenTools
Linux
Inprise Application Server
サンプル
パフォーマンス
国際化対応
マニュアル


全般

ヒント:

JBuilder 3.5 と JBuilder 4 の使用

JBuilder 3.5 では ".jbuilder" ディレクトリに各種設定が収められていました。JBuilder 4 でこのディレクトリは ".jbuilder4" に変更されています。また JDataStore の設定は ".jdatastore4" に収められます。

既知の問題:

JBuilder 4 の新機能

新しい機能については,「クイックスタート」のJBuilder 4 の新機能を参照してください。

[トップ]


インストール

ヒント:

インストールの説明については,setup_<platform>.html を見てください。その指示に従うことが非常に重要です。

Linux

次の問題が発生する可能性があります:

システムの最低スペックが指定された要求スペック以上なのに,JBuilder の実行が遅い。

解決策:

Linux カーネルは,利用可能な総メモリ数を返さないいくつかのマザーボード/BIOS での動作に問題があります。インストールしたメモリが認識されているかどうかを確認するには,次のコマンドをシェルプロンプトで入力します。

cat /proc/meminfo

次のような行が出力されます。

MemTotal: ######## kB 

「########」がコンピュータの物理メモリ搭載量と一致するはずです。もし一致しなければ,/etc/lilo.conf を編集してカーネルに明示的に指定する必要があります。

その方法の詳細は,http://www.redhat.com/support/docs/faqs/rhl_general_faq/FAQ-7.html を参照してください。

JBuilder のアンインストール

JBuilder をアンインストールするには,

  1. JBuilder がインストールされているディレクトリを調べます。
  2. JBuilder ディレクトリを削除します。
  3. 次のディレクトリにある .jbuilder4 ディレクトリを削除します。

既知の問題

[トップ]


Enterprise JavaBeans(EJB)

Inprise Application Server のバージョン 4.1.1 以上を使用しないと,JBuilder 4 の Enterprise JavaBeans 開発機能が正しく動作しません。 Inprise Application Server 4.1.1 は,JBuilder Enterprise と一緒にインストールされるバージョンです。

JBuilder 4 を使った EJB の開発と配布についてのチュートリアルや追加情報については,「Enterprise JavaBeans 開発者ガイド」を参照してください。

既知の問題:

[トップ]


Web 開発

JSWDK1.0 ライブラリは,もう使われていません。JBuilder は現在 Tomcat サーブレットエンジンを使っています。Web サーバーを統合し直したため Web サーバーライブラリを宣言する必要がなくなり,JSWDK と置き換えなければならない Tomcat ライブラリもなくなりました。JSWDK1.0 ライブラリを使用しているプロジェクトがある場合は,必須ライブラリから削除してください。

既知の問題:

[トップ]


チーム開発

CVS の性能を完全に利用するには,CVS のバージョン 1.10.8 以上を使うことをお勧めします。

既知の問題:

SSH を使った CVS の利用

JBuilder のチーム開発機能を使用する場合,SSH を使って CVS サーバーへの接続のセキュリティを保護することができます。SSH を使うと,ホストマシンに強力な暗号を使って接続することができ,機密データの機密性が保証されます。

JBuilder は,このオプションをサポートしています。SSH1 を使用し(SSH2 も動作するはずですが,テストしていません),SSH がパスワードを尋ねないように接続を設定しなければなりません。この点は非常に大切です。SSH がパスワードなしに接続するように設定しておかないと,JBuilder は SSH プログラムを明示的に終了するまでフリーズしてしまいます(詳細については,SSH のマニュアルを参照してください)。

接続が正しく設定されたことをテストするには,JBuilder で試す前に ssh の後に接続したいサーバー名を付けて入力してください。たとえば,サーバーが codecentral という名前なら,次のように入力します。

ssh codecentral

SSH がパスワードを聞かずにサーバーに接続すれば,JBuilder で SSH を使用することができます。

SSH を正しく設定したら,CVS の設定ページでパラメータを指定する必要があります。設定は次のように行います。

  1. [チーム|バージョンコントロールの設定]を選びます。
  2. CVS の設定ページの接続タイプに[外部]を選択します。
  3. サーバー名と,そのサーバーのユーザー名を入力します。
  4. [リモートシェル]には,ssh と入力します。

パラメータをこのように指定すると,データ転送に強力な暗号を使用した,セキュリティの保護された環境ですべての CVS 処理が実行されます。

[トップ]


エディタ

既知の問題:

[トップ]


コンポーネント

日付値の編集

dbSwing と JBCL コンポーネントは,日付の値を編集したときに予期しない結果が起こるのを防ぐために,デフォルトのパラメータである2桁の年数を4桁に変換します。dbSwing の JdbTextField と JdbTable も,カスタム displayMask を使って編集をコントロールするとき4桁の年数に置き換えます(editMask を指定したときを除く。この場合,editMask が編集をコントロールします)。JdbTextField は,日付またはタイムスタンプを表示するときにこの変換を行います。ほかのコンポーネントは,日付またはタイムスタンプが編集されるまで待ちます。編集した値の解析に使われたパターンは変更されません。

この理由を理解するには,2桁の年数を指定したパターンを使って日付値を解析したときの Java のデフォルトの振る舞いを理解しておかなければなりません。日付の文字列に2桁の年数が含まれる場合,その年数は,現在の日付の80年前から20年後までの間にあるものと見なされます。それ以外の場合(つまり,年数が1桁,3桁または4桁の場合)は,年数はそのまま使われます。この規則の結果どうなるかは,次の例を考えるとわかります。

完全な4桁の年数を使うように指定すると,この現象は防げます。その場合でも,新しい値を入力するときに2桁の年数を入力して 20 世紀なのか 21 世紀なのかを Java に判断させることも,4桁の年数を入力してユーザーが世紀を指定することもできます。2000年から2009年の間の場合,0で始まる2桁の数の文字列として表されることに注意してください。上の規則にあるとおり,1桁の年数は20世紀または21世紀の年とは見なされません。

既知の問題:

[トップ]


デバッガ

ヒント:

ブラウザ(IE 5 または Netscape Navigator 4.72)で JDK 1.3 を使ってアプレットをデバッグする

  1. Sun のサイト http://java.sun.com/products/plugin/ から JDK 1.3 のプラグインをダウンロードし,インストールします。
  2. Sun のサイト http://java.sun.com/products/plugin/1.3/features.html から HTML コンバータをダウンロードし,インストールします。
  3. http://java.sun.com/products/plugin/1.3/docs/debugging.html の説明に従って,アプレットの Java プラグインのデバッグパラメータを設定します。
    (適切であれば)-classic を第1引数として追加し,従来の VM を使ってデバッグするようにします。
  4. JBuilder の使い方:
    1. HTML ファイル付きの簡単なアプレットを作成します。
    2. プロジェクトをコンパイルします。
    3. HTML コンバータを使って HTML ファイルを変換します。HTML コンバータの使い方の説明は,http://java.sun.com/products/plugin/1.3/docs/htmlconv.html にあります。
    4. アプレットファイルにブレークポイントを設定します。[プロジェクトプロパティ]の[デバッグ]ページで,[リモートデバッグを使用]を有効にし,次のパラメータを入力します。
      • dt_shmem を使い,アドレスが javadebug の場合,トランスポートに dt_shmem を選択し,アドレスに「javadebug」と入力します。
      • dt_socket を使っている場合,トランスポートに dt_socket を選び,コントロールパネルで与えられたアドレス(JBuilder の与えるデフォルト値は 5000)を入力します。リモートデバッグの詳細については,「分散アプリケーション開発者ガイド」の「分散アプリケーションのデバッグ」を参照してください。
  5. ブラウザ(Netscape または IE)を起動します。html ファイルを開きます。JBuilder に切り替え,プロジェクトのデバッグを始めます。デバッガが起動するはずです。ブラウザに戻り,ページを更新します。JBuilder で,デバッガがアプレットのブレークポイントで停止するはずです。

既知の問題:

[トップ]


デザイナ

ヒント:

「Red Bean」

クラス名が上に付いた赤い箱のコンポーネントは,JBuilder がデザイナに対してそのインスタンスを作成できなかったことを表します。これを「Red Bean」といいます。「Red Bean」が表示されるのには,いくつかの理由があります。

項目(1)および(2)は,適切なコンストラクタを与えるか,そのクラスのサブクラスを作ってデフォルトのコンストラクタを用意すれば解決できます。項目(3)は,もっと複雑です。JBuilder がオブジェクトをインスタンス化して「this」オブジェクトにする必要があるときは必ずパラドックスに陥ります。設計中のオブジェクトはインスタンス化できません。この問題から抜け出すために,JBuilder は普通「this」オブジェクトのスーパークラスをインスタンス化しようとします。スーパークラスが抽象クラスの場合はインスタンス化できません。これは次のようにして解決します。

ファイル「.jbuilder4/user.properties」に次のような行があります。

designer;proxy.java.awt.Component=com.borland.jbuilder.designer.dt.ComponentProxy

この行は,com.sun.java.swing.Jcomponent(これは抽象クラス)をインスタンス化するときは,次の場所からその代わりの具象クラスを探し出すことを表しています。

com.borland.jbuilder.dt.JComponentProxy

このパターンを利用すれば,代替オブジェクトを追加することができます。代替クラスの役割は次の項目のみです。

  1. 問題の抽象クラスを拡張します。
  2. 具象クラスにしておきます(自分自身は抽象クラスとして宣言しません)。
  3. public にしておきます(クラス,コンストラクタの両方)。

既知の問題:

[トップ]


データベースと JDataStore

ヒント:

アプリケーションの配布

リモートアクセスに対する JDataStore JDBC サーバーの配布については,「JDataStore 開発者ガイド」の「JDataStore JDBC サーバーの配布」に書かれています。JDataStore クライアントアプリケーションの配布サイズを小さくするヒントについては,「JDataStore 開発者ガイド」の「配布されたリソースのプルーニング」にあります。

JDBC ドライバの JBuilder への追加

メーカーの説明書に従って JDBC ドライバをインストールしたら,次の手順で JBuilder で使用できるように設定します。

メモ:[Connection プロパティ]ダイアログボックス,JDBC エクスプローラ,または JDataStore エクスプローラのドライバ一覧で赤で表示されているドライバは,クラスパスに存在しません。選択することはできますが,それを使って定義する接続や URL はクラスパスに追加されるまで動作しません。

.library および .config ファイルの作成

データベースドライバを JBuilder に追加するには,次の3つの手順が必要です。

最初の2つの手順は,1つのダイアログボックスで実行できます。

  1. JBuilder を開き,[ツール|エンタープライズの設定]を選びます。[データベースドライバ]タブをクリックします。ここには,現在 .config ファイルにあるすべてのデータベースドライバが表示されます。
  2. 新しいドライバを追加するには[追加]をクリックし,まずドライバのライブラリファイルを作成するために[新規]をクリックします。ライブラリファイルは,ドライバをプロジェクトの必須ライブラリのリストに追加するのに使います。 メモ:[ツール|ライブラリ設定]で,新しいライブラリを作成することもできますが,.config の導出に[エンタープライズの設定]を使うので,すべて[エンタープライズの設定]で設定する方が簡単です。
  3. [新規ライブラリの定義]ダイアログボックスで,新しいファイルの名前を入力し,保存場所を選びます。
  4. [追加]をクリックし,ドライバの位置を参照します。ドライバとそのサポートファイルを含むディレクトリを選択することも,ドライバのアーカイブファイルだけを選ぶこともできます。どちらでも動作します。JBuilder は,必要な情報を展開します。
  5. [OK]をクリックし,ファイルブラウザを閉じます。すると,新しいライブラリがライブラリ一覧の末尾に表示されるので,それを選択します。
  6. [OK]をクリックします。JBuilder は新しい .library ファイルを JBuilder の /lib ディレクトリに,指定した名前(たとえば,InterClient.library)で作成します。[データベースドライバ]ページに戻り,ライブラリファイルから導出される,対応する .config ファイルの名前(たとえば InterClient.config)の一覧が表示されます。
  7. [OK]をクリックします。すると,.config ファイルが JBuilder の /lib/ext ディレクトリに作られます。
  8. JBuilder を閉じて再起動し,データベースドライバへの設定を反映させます。新しいドライバが JBuilder のクラスパスに置かれます。

重要:.config ファイルの導出後に .library ファイルを変更したら,[エンタープライズの設定]を使って .config ファイルを生成し直し,JBuilder を再起動します。

JDBC ドライバをプロジェクトに追加する

JBuilder から実行されるプロジェクトは,そのプロジェクトに対して定義されているクラスパスのみを使います。したがって,JDBC ドライバが,それを必要とするすべての新規プロジェクトで必ず利用できるようにするには,ライブラリを定義して必須ライブラリのデフォルトリストに追加します。これは,JBuilder から次の手順で行えます。

  1. JBuilder を起動し,開いているプロジェクトをすべて閉じます。
  2. [プロジェクト|デフォルトプロパティ]を選びます。
  3. [パス]ページの[必須ライブラリ]タブを選択し,[追加]ボタンをクリックします。
  4. 新しい JDBC ドライバをライブラリリストから選択し,[OK]をクリックします。
  5. [OK]をクリックして[デフォルトのプロジェクトプロパティ]ダイアログボックスを閉じます。

メモ:JDBC ドライバを既存のプロジェクトに追加することもできます。プロジェクトを開いて[プロジェクト|プロジェクトプロパティ]を選び,上と同じ手順で追加するだけです。

これで,JBuilder と 新規 JDBC ドライバがともに動作するように設定されました。次は,このドライバを使用するプロジェクトを作成するか開き,Database コンポーネントを追加し,connection プロパティを設定してそのドライバを使用したり,データにアクセスしたりできるようにします。その方法の一例については,「データベースアプリケーション開発者ガイド」のチュートリアル:InterClientを使ってデータベースに接続するを参照してください。

既知の問題:

[トップ]


ウィザード

既知の問題:

[トップ]


実行時

JDK 1.2 アプレットの実行

Solaris または Linux で,JBuilder なしにアプレットを実行するには,プロジェクトに「Open Tools SDK library」を追加しなければなりません。このライブラリを追加しないと,「NoClassDefFoundError:AppletTestbed」に関する例外となることがあります。この問題は現在のところ,Primes Swing など,いくつかのアプレットのサンプルに影響を与えています。

JDK 1.1.x アプレットの実行

アプレットの[プロジェクトプロパティ|実行]ページで,アプレットをそのメインクラスから実行するか,HTML ファイルから実行するかを指定できます。

既知の問題:

[トップ]


ヘルプビューア

既知の問題:

[トップ]


Linux

ヒント:

Linux と Solaris プラットフォーム上での印刷

デザイナで AWT コンポーネントを使用する必要がなく,lpr 以外のプリンタを選択できるようにしたい Unix プラットフォームのユーザーは,LightWeight Toolkit をブートパスに加えている JBuilder.config ファイルの次の行をコメントアウトしてください。

# Put the Lightweight Toolkit on the boot path 
#addbootpath ../lib/lawt.jar 

既知の問題:

[トップ]


Inprise Application Server

既知の問題:

[トップ]


OpenTools

既知の問題:

[トップ]


サンプル

OnlineStore サンプルはサブディレクトリ「OnlineStore/database」に,各プラットフォーム用の InterBase データベース(.gdb)ファイルを必要とします。データベースファイルは,Windows,Solaris,Linux プラットフォーム用のものが用意されています。OnlineStore サンプルを実行する前に,各プラットフォーム用の acmecb データベースと cliffhanger データベースの両方を,ふつうの .gdb ファイル拡張子のファイル名でコピーしておく必要があります。たとえば,Windows でサンプルを実行するには,「acmecb.gdb.windows」を「acmecb.gdb」に,「cliffhanger.gdb.windows」を「cliffhanger.gdb」にコピーします。

Samples.html ファイルは,JBuilder の AppBrowser,または Welcome プロジェクト内のリンクから表示します。

既知の問題:

[トップ]


パフォーマンス

これは,JBuilder 4 のローカルパフォーマンスの向上のための提案です。

[トップ]


国際化対応

日本語 NEC マシンへのインストール

[75607] JBuilder を日本語 NEC コンピュータにインストールしようとして,インストールプログラムが「Drive C: is not ready... the drive door may be open...」というオペレーティングシステムエラーが起きた場合,ダイアログの<Ignore>ボタンを押します。インストールは正常に終了します。(<Abort>ボタンも効きます。)

Linux

Solaris

Windows

Inprise Application Server

(Enterprise 版に付属)

コマンドラインコンパイラ

その他の既知の問題:

[トップ]


マニュアル

印刷物のマニュアルも,JBuilder 4 の製品 CD に PDF 形式で収録されています。Pdf ディレクトリには次のファイルがあります。

PDF ファイル

印刷物のマニュアル

database.pdf 「データベースアプリケーション開発者ガイド」
enterprise.pdf

「エンタープライズアプリケーション開発者ガイド」

  • 「JBuilder を使って行うチーム開発」
  • 「Web アプリケーション開発者ガイド」
  • 「分散アプリケーション開発者ガイド」
  • 「Enterprise JavaBeans 開発者ガイド」
java-jb.pdf

「JBuilder で学ぶ Java」

  • 「クイックスタート」
  • 「Java 入門」
  • 「チュートリアル」
jdspg.pdf 「JDataStore 開発者ガイド」
pg.pdf 「アプリケーションの構築」

メモ:JBCLリファレンスについて

JBCL (ボーランドのコンポーネントライブラリです。現在は使用されていません)のリファレンスはヘルプビューアからは削除されています。参照したい場合は、doc/jb_jbclref.jar を手動で展開してください。

既知の問題:

[トップ]


Apache Software Foundation conditions and disclaimer:

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment: "This product includes software developed by the Apache Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear.
  4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact apache@apache.org.
  5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation.

THIS SOFTWARE (Tomcat) IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

[トップ]