日本語 NetBeans 開発者 FAQ

このページは現在翻訳中です。一緒に翻訳して下さる方を募集しています。プロジェクトページ を参照のうえ masaki.katakai @ sun-dot-com まで連絡下さい。また英文と違う箇所がありましたらお知らせください。

• 開発者 FAQ 分担表

これは NetBeans 4.x や 5.x の開発者向けの FAQ です。開発者 とは NetBeans もモジュール(プラグイン)や NetBeans Platform 上にアプリケーションを開発している人のことを指します。

ここにない質問は開発者向けのメーリングリスト dev@openide.netbeans.org へおたずね下さい。(登録)

他の FAQ やトラブルシューティングは FAQ の索引 をご覧下さい。

重要: FAQ ページに項目を追加する時にはページの名前は Faq<Topic> から始めて下さい。 例: FaqInstallLibsLinux

日本語情報

• NetBeans に関する日本語の情報はどこから参照できますか?
• NetBeans に関する日本語のメーリングリストはありますか?
• プラグイン開発に関する技術文章を寄稿したいのですがどうしたらよいですか?
• プラグイン開発に関する NetBeans 英語サイトのドキュメントを訳したのですがどうしたらよいですか?
• プラグイン開発に関する NetBeans に関するブログを書いています。プラネット NetBeans に登録するのはどうしたらよいですか?

入門

• CVS を使ってどのように NetBeans のソースを取得したらよいですか?
• standardの CVS モジュールとは何ですか? またstableとどう違いますか?
• NetBeans のバグを修正しました。パッチを提供できますか?(参照先は英語)
• NetBeans モジュールを作成しました。NetBeans プロジェクトに提供できますか?
• モジュールを作成しました。販売することはできますか?
• なぜいくつかのパッケージ名は org.netbeans.api.なんとかで他は org.netbeans.なんとか.api なのですか?
• netbeans.exe はなんですか? 誰がコンパイルしなぜそこに置いてあるのでしょう?
• NetBeans CVS のコミットアクセスをどのように取得すればよいですか?(参照先は英語)
• IDE や Platform の Javadoc はどこにありますか?

チュートリアルと出発点

• NetBeans のアーキテクチャに関して理解しておいたほうがよい基本的なことはなんですか?(★まだ)
• チュートリアルはありますか?
• NetBeans API の出発点
• NetBeans プラグインモジュールのクイックスタートガイド

サポートを得るには？サンプルはどこにありますか？

• NetBeans メーリングリスト - 多くの開発者にヘルプしてもらうことができます
• モジュール開発者のメーリングリストのアーカイブを検索
• NetBeans 開発者のメーリングリストのアーカイブを検索
• バグを登録する(★まだ)
• いろいろな API を使用するサンプルはどこにありますか?
• サンプルをオンラインで閲覧するにはどうしたらよいですか?

開発時の問題、モジュールの基本とクラスパスの問題

• My module uses some libraries. I've tried setting CLASSPATH but it doesn't work. Help!
• How do module dependencies/classloading work?
• What classloaders are created by the module system?
• I need to package some third party libraries with my module. How do I do that?
• What is an "NBM"?
• Can I sign NBMs I create?
• My module requires JDK 5.0, or 6.0 - how do I keep it from being loaded on an older release?
• What is a library wrapper module and how do I use it
• When should I use a library wrapper module and when should I just package the library into my module?
• How to store external libraries in the NetBeans CVS repository
• What is an implementation dependency and what/how/when should I use one?
• My module uses class XYZ from NetBeans' APIs. It compiles, but I get a NoClassDefFoundError at runtime. What gives?
• Help! What is my class path? Why am I getting NoClassDefFoundErrors?
• What is a module cluster?
• What is the difference between a suite and a cluster?
• Whenever I start NetBeans, I get warnings that some modules use deprecated APIs. Is that why XYZ doesn't work?

• Is there a standard way to provide user documentation (help) for my module?
• Where is TopManager? I'm trying to do the examples from the O'Reilly book
• There is a class under org.netbeans.core that does what I need. Can I depend on it?
• Common calls that should be done slightly differently in NetBeans than standard Swing apps (loading images, localized strings, showing dialogs)
• How do I create a patch for a preexisting NetBeans module?
• I want to combine the 5.0 Platform with the 5.0 Update 1 build harness in one binary. Can I?
• I am developing a NetBeans module. What performance criteria should it satisfy?
• I want to disable assertions or set some other flag when I run my NB-based application. How do I do that?
• How can I fix memory leaks?
• How can I profile NetBeans?

設定: モジュールのインストール

• What are the ways a module can influence the system?
• When do I use what registration method?
• Installing things declaratively vs. installing things programmatically
• What is the "default Lookup"?
• How do I run some code when my module starts/loads/unloads?
• What is a module layer (XML layer) or layer file
• What is the system filesystem
• How can I see the filesystem?
• What are .instance files
• What are .settings files
• What are .shadow files
• What is the user dir, what is in it, and why do I need one?
• How do I specify the order for my menu items/toolbar buttons/files in the system filesystem?
• I want to disable a module programmatically. How?

Action: ファイル、フォルダ、メニュー、ツールバーなどにアクションを追加するには

• メインメニューにアクションを追加するにはどのようにしたらよいですか?
• メインウィンドウのツールーバーにアクションを追加するにはどのようにしたらよいですか?
• セクションにより自動的に有効、無効になるアクションを作るにはどのようにしたらよいですか?
• システムファイルシステムのアクションフォルダとは何ですか、そしてなぜそれを使うべきなのですか?
• 独自の mime-type のすべてのファイルにアクションを追加するにはどのようにしたらよいですか?
• テキストエディタのポップアップメニューにアクションを追加するにはどのようにしたらよいですか?
• プロジェクトポップアップメニューにアクションを追加するにはどのようにしたらよいですか?
• 特定のプロジェクト形式のプロジェクトポップアップメニューにアクションを追加するにはどのようにしたらよいですか?
• フォルダにアクションを追加するにはどのようにしたらよいですか?
• カスタムノードタイプにアクションを追加するにはどのようにしたらよいですか?
• ポップアップメニューにサブメニューを持つノードを作るにはどのようにしたらよいですか?
• ノードごとのツールメニューにアクションを追加するにはどのようにしたらよいですか?
• ツールバーにドロップダウンメニューを追加するにはどのようにしたらいいですか?
• 動的にツールバーを隠したり、表示したりするにはどのようにしたらよいですか?
• IDE など、いくつかのモジュールはすでに必要なメニューアイテムを持っています。ただそれに新しい名前をつけようとします。可能ですか?
• エディタ内で選択されたファイルに応じてメニューの内容を変更、またはメニュー全体を非表示、表示することができますか?
• 正式なアクションの代わりに、サブメニューをポップアップやその他のメニューに設置する事はできますか?
• MainWindow の閉じるアクションを変更するにはどのようにしたらよいですか?
• プラットフォームアプリケーション内の File メニューの Open File アイテムを取得するにはどのようにしたらよいですか?

Key Bindings

• How do key bindings work?
• Binding one key to more than one action
• Why should I use D- for Ctrl and O- for Alt? I thought C- stood for Ctrl and A- stood for Alt!
• I want my action to appear between to existing items/in a specific place in the menu. Can I do that?
• Why do ordering attributes need boolvalue="true"?
• What about editor-specific keybindings?

Lookup

• What is a Lookup?
• What uses Lookup?
• Why use Lookup - wouldn't a Map be good enough?
• How do I use Java generics with Lookup?
• What is the "default Lookup"?
• What is the difference between getCookie(Class), SharedClassObject.findObject(Class) and Lookup.lookup(Class)?
• How do I implement my own lookup or proxy another one?
• If there is more than one of a type in a Lookup, which instance will I get?
• How can I find out what is in a Lookup
• How can I add support for lookups on nodes representing my file type?
• After adding my class to Lookup I get a "ClassNotFoundException" when trying to look it up, why?

File と DataObject

• NetBeans はどのようにしてファイルを認識するのですか?
• FileObject とは?
• FileSystem とは? (未)
• ファイルの属性とは?
• DataObject とは? (未)
• DataLoader とは? (未)
• ファイルが変更されたり保存されたりした時に通知を受けるには?
• システムに存在する全てのフォルダのポップアップメニューにメニューアイテムを追加するには?
• すべての Java ソースファイルのコンテキストメニューにメニューアイテムを追加できますか?
• ファイルシステムを実装しようとして問題に突き当たっているのだけれど....
• XML タイプに異なる拡張子でサポートを追加するには?

Converting between common data types and finding things

• FileObjects versus Files
• URIs and URLs
• How do I get a java.io.File for a FileObject?
• How do I get a FileObject for a File?
• How do I get a DataObject for a FileObject?
• How do I get a FileObject for a DataObject?
• How do I get a Node for a DataObject?
• How do I get a DataObject for a Node?
• How do I get a reference to the system filesystem?
• I have a .instance file. How do I get an actual object instance?
• I have a folder full of .instance files. How do I get any/all of the object instances?

Editor and Edited Files

• How can I open a file in the editor in read-only mode?
• Is it safe to programmatically modify a file which is open in the editor?
• How can I get a list of open editor windows?
• How can I get the position of the caret in the currently selected editor window?
• How can I open a particular file at a particular line number?
• Can I add a menu item to the context menu of the Java source editor?
• How can I find the currently open document in the selected editor?
• How can I track what file the user is currently editing?
• I want to make some programmatic changes to the edited file. How can I do it so one Undo undoes it all?
• Can I add syntax coloring for my own data object/MIME type?
• What is MimeLookup?
• How can I create JEditorPane for a specific document type?

Module システム

• 自作のモジュールから、通常使用可能になっている別のモジュールを使用不可にしたいのですが、可能ですか？
• 開発中のモジュールのデバッグ方法を教えてください
• UI を表示することなく自動アップデートを操作できますか？

Nodes and Explorer

• Node とは何ですか？
• "explorer" とは何ですか？
• ExplorerManager とは何ですか？
• Explorer View とは何ですか？
• どのようにしたら私は Explorer View に Node を表示することができますか？
• I need to create my own Nodes. What should I subclass?
• How do I create a TopComponent (tab in the main window) to show some Nodes?
• I have a reference to an existing Node from some other module. Can I add cookies/properties/children?
• Can I add or remove children of a node on the fly?
• How do I make a particular node visible in the Explorer, and maybe select it?
• How do I get at the file that a particular node represents?
• Tracking selections in the Explorer
• I need to customize the content of my Node's Lookup. How do I do it?
• I need to write some code that tracks the global selection. What should I do?
• How do I "decorate" nodes that come from another module (i.e. add icons, actions)?
• How do I preserve the column attributes of a TreeTableView?
• How do I remove the "..." buttons of a TreeTableView?
• How can I make sortable columns in a TreeTableView?
• How can I add a "View" capability for data my node represents?
• How can I implement "Select all/Deselect all/Invert selection" features?
• Why do my nodes in the Explorer always have an expand-box by them, even though they have no children?

設定

• レイヤを通じてSystemOptionを追加しましたが、ランタイムへの変更が永続化されません。どうなっているのでしょう？
• .settings ファイルと SystemOption の違いはなんですか？
• SystemOption の利用方法について、分かりやすいサンプルはありますか？

Window System

• What is the window system
• What are Modes?
• What are TopComponents?
• How do I use Matisse/GroupLayout (new form editor/layout manager in 5.0) in my windowing system components
• I want to show my own component(s) in the main window - where do I start?
• Windows and dialogs
• How does the XML API for installing window system components work?
• How do I use .wstcrf/.wsmode/.settings files to install my module's components in the window system?
• My TopComponent always opens in the editor area, but I want it to open in the same place as XYZ
• Why does TopComponent have a getLookup() method? What is it for?
• I want to disable the popup menu on the toolbars in the main window. How do I do that?
• How can I change the executable's icon?
• How does the window system ''really'' work?

Wizards and Templates

• How do I make a file template which actually creates a set of files at once?
• I am creating a non-IDE application. How do I enable/control templates?

Properties and PropertySheet

• How do I change the default behavior of PropertySheet editors?
• How do I show my node's properties in the Properties view?
• How do I display different groups of properties on buttons in the property sheet the way Matisse does?

出力ウィンドウ

• How do I create my own tab in the output window and write to it?
• 外部プロセスの出力を出力ウィンドウに表示させるにはどうしたらよいですか?

Programmatic access to Java Sources

• JavaModel...MDR...Metamodel...RefObjects...MultipartIds...what is これ、いったい何ですか？？？
• プログラムからJavaのソースにメソッドを追加する方法は？
• 新しいクラスの作り方は？
• 何か実用的なことをするために知っておくべきことは？
• キャレット配下の要素はどのように取得すれば良いですか？
• Resourceって何ですか？
• JavaClass って何ですか？
• ClassDefinition って何ですか？
• クラスの名前から型を調べるにはどうすれば良いですか？　例： "com.bar.Foo" の型を知るには？
• 既存のクラスからFeature（例：フィールド）を削除する方法は？
• 既存のクラスへの参照を取得するには？
• ResouceからJavaClassを取得するには？
• FileObject を保持しています。この FileObject用の Resource / JavaClass を取得する方法は？
• トランザクション・ロックとは何ですか？どんな時に使用するのですか？
• InvalidObjectExceptionsが発生するのはなぜですか？
• ソース内に空白やコードのないテキストを含めるにはどうすればいいですか？
• ソース要素に含まれる改行やコメントをチェックしたいのですが、テキストはどのように取得すれば良いですか？
• あるクラスを参照するコードを生成したいのですが、そのためのimport文を生成するにはどうすればいいですか？
• MultipartId を取得しました。これが FQN (完全修飾名)かどうかを調べる方法は？

Using Enterprise Resources from NetBeans module

• How to create Java EE Application Client on top of NetBeans Platform
• How to call EJB from NetBeans module

Writing tests

• Testing things that use FileObjects
• Writing Tests for DataObjects and DataLoaders

Some more questions that could be answered

Create a new file and set its contents to something?

I added a bunch of cookies to my data object, but still things like Open are not on the context menu.

Listen to renames, deletes, creations, modifies, saves of files?

What is a "data object representation class" anyway?

How to capture double-click on a node to do something else? What about when a template is instantiated?

How do I tell when a piece of source code has been modified by the user?

Can I add templates from my module? What is the easiest way to do this?

What is the relationship between EditorCookie, StyledDocument, and NbDocument & EditorSupport?

Save, rename a file?