Olen Onnellinen 2 » Eclipse

URLエンコード/デコードを行う Eclipse プラグインを公開

koshian — Sat, 25 Apr 2009 19:30:23 +0000

しました。

Olen Onnellinen 2 – URLエンコード/デコードプラグイン

Web の開発をしていると、たまに URLデコードをしたいときがあります。

そんなときには Web 上に公開されている無料のフォームを使うのですが、いくつか気になる点がありました。

いちいち Web サイトを開かなくてはならない
文字制限がある
デコード時に文字コードを自動判定してしまうものが多く、テストに不向き

これらの点を踏まえ、Eclipse のプラグインとして作成したものが URLエンコード/デコードプラグインになります。

機能のわりに大仰な、という意見もあると思いますが、ちょっとした機能を追加していくことにより、より便利なツールセットになれば、と思いますので「こんな機能が欲しい」といった要望がありましたらぜひお知らせください。

Eclipseの水平ルーラー

koshian — Sun, 15 Mar 2009 08:34:40 +0000

Eclipse のエディタに水平ルーラーをつけてみました。

どうやって実装するかイメージがなかったのですが、 COBOL Editor なるものに水平ルーラーが実装されていたので、それを参考にしました。

簡単にいうと、SWTのコンポーネントを置いているだけですが、フォントやら日本語など、スクラッチじゃできなかっただろうなーと思います。

で、COBOL Editor の中に気になる箇所を見つけた。

■ スニペット
水平ルーラーのマーク位置を設定するところ。

char[] ch = new char[] {document.getChar(i)};
byte[] by = new String(ch).getBytes();
column += by.length;

例えば、”ほげほげほ”というテキストの末尾にカーソルがある場合、全角は2文字分の幅を使うのでルーラーの目盛は10になるはずです。

上記はその実装なのですが、UTF-8では全角日本語は3バイトだったりするのでバイト基準では、ずれてしまう…と思うのですがどうなんでしょう。

現在のコントリビュータは日本の企業なので、気付いていないって事もなさそうなんですけど。

Eclipseプラグイン開発：ハイパーリンクのスタイル指定

koshian — Tue, 27 Jan 2009 13:09:38 +0000

久しぶりに Eclipse のプラグイン開発の話を。

テキストエディタ内にハイパーリンクを作ったときのスタイルを指定する。

ハイパーリンクにカーソルをあわせたとき、「青字、下線付き」になることを期待しますよね。
ところがハイパーリンクは動くものの、「青字、下線付き」にならないという現象に遭遇。そして原因がわからずはまったのでメモ。

まず、「青字、下線付き」となることを期待する根拠は SourceViewerConfiguration の実装です。

public IHyperlinkPresenter getHyperlinkPresenter(ISourceViewer sourceViewer) {
return new DefaultHyperlinkPresenter(new RGB(0, 0, 255));
}

このようになっています。そのため、特別 Override しない限り、プレゼンテーションにはこの DefaultHyperlinkPresenter を使うことになります。
この DefaultHyperlinkPresenter には以下のコメントがあります。

The default hyperlink presenter underlines the link and colors the line and the text with the given color.

つまり、「青字、下線付き」ですよね。
それなのに、どうにも反応がありませんでした。
それでどうしたかというと、DefaultHyperlinkPresenter#applyTextPresentation 辺りにブレークポイントを設定してフィールド等を調べてみました。

結果わかったことは、範囲（Region）がうまく設定されてないってことです。
IHyperlink の実装クラスで Region を返すのですが、この Region が正しい範囲を指定していなかったのです。

public IHyperlink[] detectHyperlinks(ITextViewer textViewer, IRegion region, boolean canShowMultipleHyperlinks) {
// （略）
// !! パラメータの region をそのまま渡しちゃってる !!
// これはリンクを検出する前の範囲！
hyperLink = new HogeHyperLink(region);
// （略）
}

IHyperlink の実装クラス（ここでは HogeHyperLink）に渡す範囲は検出時に計算したものじゃないとダメ（当たり前）。

public IHyperlink[] detectHyperlinks(ITextViewer textViewer, IRegion region, boolean canShowMultipleHyperlinks) {
// （略）
// 検出結果のリンク文字列に対応した範囲を渡す！
hyperLink = new HogeHyperLink(new Region(linkOffset, linkOffsetLength));
// （略）
}

あとは HogeHyperLink#getHyperlinkRegion で渡されてきた Region をそのまま返せば OK です。

単純なミスなのですけど、はまったので残しておきます。
げふ。

Eclipse 3.4 プラグイン開発徹底攻略 Eclipse 3.4 Ganymede対応

PDT2.0を使ってみた

koshian — Sat, 24 Jan 2009 11:55:42 +0000

PDT2.0を使ってみたので、初期設定のメモだけ残しておきます。

まずはダウンロードページからAll-In-Oneをダウンロードします。

PHP Development Tools (PDT) – Downloads

こしあんの環境では以下のパッケージをダウンロードしました。

All-In-One PDT 2.0 (Windows 32-bit)

他にはお好みでプラグインをインストールします。
こしあんは日本語化の Pleiades と空白文字の可視化の JStyle をインストールしました。

Pleiades (Eclipse プラグイン日本語化プラグイン)

で、Eclipseの設定をします。
PHPとしては[PHP]→[PHP実行可能ファイル]→[追加]でPHP、設定ファイルの場所を設定しておきます。

これでPHPスクリプトを作成し、右クリックで実行できます。

※ デバッガの設定をしていない場合、PHPスクリプトを実行しようとすると”Launch Error – Session Terminated”エラーになることがあります。このときは、実行設定の”Display debug information when running”のチェックをはずしておけばOKです。

おつかれちゃん。

Eclipseのスニペットとテンプレート

koshian — Tue, 02 Dec 2008 05:40:17 +0000

前回Eclipseのスニペット(Snippet)を紹介したのですが、もろもろ紛らわしい機能でして、誤解を与えそうってことでもう少し解説します。

貴方の思う”萌え”と、わたしの思う”萌え”は別なのよ、ということですね。わかりにくい！

えっと、まずは Eclipse3.3 のJDT(Java Development Tools)を前提として、機能を説明します。

■ コード・テンプレート
EclipseでJava開発をしていると、以下のようなコードが自動生成されることがありますよね。

} catch (Exception e) {
// TODO 自動生成された catch ブロック
e.printStackTrace();
}

他にも新規にクラスファイルを作成したときなどに自動生成されるコードがあります。

ここで自動生成される雛形はユーザが設定できるようになっています。
[設定]→[Java]→[コード・スタイル]→[コード・テンプレート]

これがコード・テンプレート機能です。

■ テンプレート
Javadocの中で文字列を選択し、Ctrl+Spaceを押すとその文字列をタグで囲むことができます。
“if”と入力してCtrl+Spaceと入力したときに”else if”ブロックなどの補完ができるのもテンプレートです。

これは[設定]→[Java]→[エディター]→[テンプレート]から変更・追加が可能です。
これがテンプレート機能です。

■ スニペット
前回こしあんが紹介したのが、これ。
コードの断片を”ビュー”から挿入することができます。

スニペットはビューです。スニペット・ビュー。大事なことなので2回い（ｒｙ

と、いうわけで以上3つの機能を紹介しました。
どれもコードの断片を貼り付ける機能で同じではないかと思われるかもしれません。まったくその通りで、ユーザにとって機能名などどうでも良いことです。それなのに、わざわざこんな紹介をしたのは、Eclipseプラグイン開発の観点からの便宜上です。

プラグイン開発の話に進む前にEclipse3.4について触れておきます。

Eclipse3.4ではスニペット・ビューが標準で付属していません。これはおそらくですが、JDTに”テンプレート・ビュー”が実装されたためと思われます。
テンプレート・ビューとスニペット・ビューはほぼ役割が同じであるため、スニペット・ビューは付属しなくなったのでしょう。

さて、やっとメイン。Eclipse3.4でスニペット・ビューと同じ機能を持つプラグインを作りたい。
方法は2つ考えられます。

WST を同梱し、SnippetContributionsを拡張する
AbstractTemplatesPage を実装したクラスを作成する

3.4からは2つ目の方法をとりたいところ。

■ 参考
TemplatesView – Eclipse SDK

ITemplatesPage – Eclipse SDK

Eclipseでスニペットを使ったり拡張したり

koshian — Fri, 28 Nov 2008 12:07:28 +0000

スニペット（Snippet）は”断片”のことであり、一般的には、コピペで使えるコードサンプルなどのことを言いますが、Eclipseではエディタ上で定型文を挿入する機能のことを言います（というかそう呼ぶことにします、面倒だから）。

かなり便利な機能なのですが、そんなに活用している人を見かけないので紹介(゜-゜=)

スニペットビューを表示するには[ウィンドウ]→[ビューの表示]→[その他]でダイアログを表示し、「一般」フォルダの中の「スニペット」をクリックします。

ビュー上で右クリック→[カスタマイズ]でユーザが独自に”断片”を登録することができ、インポートやエクスポートも行えるのですが、このとき、ユーザが独自に登録したスニペットは以下のディレクトリにxmlファイルとして保存されます。

{$workspace}\.metadata\.plugins\org.eclipse.wst.common.snippets

※ $workspace は各自のworkspace

このディレクトリ名を見るとわかる通り、スニペットビューはWST(Web Standard Tools)によって提供されています。”Web”と言いつつ、ほぼすべてのEclipseパッケージに付属している（気がする）プラグインなので、 Eclipseプラットフォーム標準の機能であるかのように使えるわけですね。

そしてさらに、このスニペットビューにはextension point「SnippetContributions」が定義してあるため、プラグイン開発者はスニペットビューを拡張することもできます。
この辺は以下のドキュメントを参照してください。単純に挿入したいテキストの設定ならplugin.xmlに書くだけでよいです。

Help – Eclipse SDK

contenttypesとextensionsが思ったように動いてくれないよぅ…(´・ω・｀)

■ 参考
WST Common Snippets subcomponent Overview

Eclipseプラグイン開発：TreeViewerの状態管理

koshian — Sun, 12 Oct 2008 09:24:41 +0000

TreeViewerのメモ。

ツリーの展開状況の取得と設定

ツリーの状態を保存しておくにはTreeViewer#getExpandedElements()を使います。

// 取得する
Object[] expandedNodes = viewer.getExpandedElements();
// なんか処理して
// 設定する
viewer.setExpandedElements(expandedNodes);

TreeViewerのときは取得できるObjectはTreeNodeオブジェクトです。
TreeNodeはコンストラクタでObjectを引数に取り、このObjectのequalsによってTreeNodeの同位性も決まります。

ツリーの開閉時に実行されるリスナーの設定

TreeListenerなるものをviewerに設定しておきます。
ここで気をつけるのはイベントの各メソッドが呼ばれた時点ではツリーの状態は開いていない（閉じていない）ということです。
例えば、treeExpanded内でTreeViewer#getExpandedElements()をコールするとトリガとなったノードは取得できません。TreeExpansionEvent#getElement()で取得します。

viewer.addTreeListener(new ITreeViewerListener() {
@Override
public void treeCollapsed(TreeExpansionEvent event) {
// 閉じるによばれる
}
@Override
public void treeExpanded(TreeExpansionEvent event) {
// 開くときによばれる
}
});

ユーザの操作だけではなく、内部でツリーを制御するタイミングでもコールされるようなので、データを操作するときは注意しておきましょう。

Eclipseプラグイン開発：F5でリフレッシュ

koshian — Fri, 10 Oct 2008 13:19:37 +0000

Viewの更新タイミング。

暫定的に右クリックメニューに「更新」アクションを追加してたのですが、F5で更新できないの？って話になりました。

あー、そうですよねー、ってことで着手したものの結構ハマったのでメモです。
お忙しい方もいると思うので、例によって先に結果から。

IAction action = new HogeAction();
getViewSite().getActionBars().setGlobalActionHandler(
ActionFactory.REFRESH.getId(), // for Eclipse3.4
action);

ざっくりだとこんな感じ。F5だのコピーだのペーストだと言った標準的な機能に乗せるときはGlobalActionHandlerに登録しとけってことです。
plugin.xmlで指定すべきなのかも…。

ハマった理由っていうのは、最初”キーバインド”でやるのかにゃーと思い込んでいたからです。
F5 をバインドしてアクション呼び出そうとすると”!MESSAGE A conflict occurred for F5:”となり、かなりイケてないことになります。ログの”ActionHandler(RetargetAction(refresh))”などを頼りにretargetへ行き着くまでに大分時間がかかりました。疲れた！
この仕組みは”リターゲットアクション”でプラグイン開発者には通じるのでしょうか(￣~￣)

Eclipseってヘルプが充実してるのですが、プラグイン開発は用語を知らないとそこまで辿りつけないのが難点ですね。こしあんだけですか。

一度横断的におさえておかないと、と思い立ったので注文しちゃいました。Eclipse本。
ちなみに新版は2009-1-2に発売だそうですよ。慌てて買う必要ありませんでしたね。高いし！とても高いし！

Eclipse: Building Commercial-quality Plug-ins2006 (Eclipse)

【参考】
Help – Eclipse SDK
Eclipse/プラグイン開発のTIPS集/再ターゲット可能なアクション – きのさいと

Eclipse RAP (Rich AJAX Platform) をいまさら知る

koshian — Tue, 30 Sep 2008 12:22:50 +0000

最近知りました。プラグインの開発とかしてるのに、存在すら知らなかったってのはどうなのでしょう。

簡単に言うと、Eclipse RCPと同程度の機能をAjaxを使ってブラウザ上で動かす仕組み、でしょうか。
使えるAPIに制限があるようですが、どの程度の制限なのか調べてみてから場合によっては使ってみたいです。

RCPがいまいち流行っていないように、RAPもあまり情報がなさそうです。
面白そうなんですけどね。

今作ってるプラグインを無理やりRAPに載せてみたら面白いかもー。

【参考】
Rich Ajax Platform
eclipse.orgが打ち出すRIAプラットフォーム「Eclipse RAP」