Java 言語バインディング – SVG 1.1 （第２版）

SVG DOM 定義に対する Java 言語バインディングは次の URL から入手できる： The Java language binding for the SVG Document Object Model definitions is available at:

この言語バインディングが公式のものでないことに注意。 IDL 定義が SVG DOM を構成する公式のものになる。 Note that this language binding is not normative. The IDL Definitions are the normative parts of the SVG DOM.

D.2 Java 言語による SVG の利用

ECMAScript などの言語による SVG に対するスクリプトにおいては ‘script’ 要素とイベント属性（例えば ‘onload’ や ‘onclick’ など）を利用して SVG 内容にスクリプトコードを直接書き込める。一方、 Java 言語などの実行形式がバイナリのプログラミング言語ではコードを ‘script’ 要素やイベント属性に埋め込むことはできない。したがって、そのような言語をどのように SVG 文書に結びつけてイベント処理させるかを指定する必要がある。次の技法では Java 言語の場合にこれをどのようにして行うべきか、 Java 言語を通して動的な SVG 内容をサポートする UA には何が求められるのかを述べる。 When scripting SVG with a language such as ECMAScript, it is possible to embed script code directly in the SVG content using the ‘script’ element and the event attributes (e.g., ‘onload’ or ‘onclick’). For programming languages with a binary delivery format, such as the Java language, it is not possible to embed the code into the ‘script’ element or within the event attributes. Therefore there is a need to specify how such languages can bind to and handle events in the SVG document. The following technique describes how this should be done when using the Java language and what is expected of the User Agent that supports dynamic SVG content through the Java language.

‘script’ 要素は、文書で発火されたイベントを処理するための, コンパイル済みコードを含む jar ファイルを参照しているべきである。例えば： The ‘script’ element should reference a jar file containing the compiled code to handle the events fired by the document. For example:

<script type="application/java-archive" xlink:href="myJavaHandlers.jar"/>

参照先の jar ファイルのマニフェストには SVG 文書のイベントリスナの初期化の責を担うクラスを定義する SVG-Handler-Class エントリが含まれる。エントリは完全修飾名にすべきである。例えば： The manifest in the referenced jar file contains an entry, SVG-Handler-Class, defining the class responsible for initializing the event listeners on the SVG document. The entry should be a fully qualified class name. For example:

Manifest-Version: 1.1
SVG-Handler-Class: org.example.svg.SVGHandler

SVG-Handler-Class から参照されるクラスは次の EventListenerInitializer インターフェースを実装する： The class referenced by SVG-Handler-Class implements the EventListenerInitializer interface defined as:

public interface EventListenerInitializer {
  void initializeEventListeners(SVGDocument doc);
}

initializeEventListeners() メソッドは、 onload イベントが発火される前に UA から呼び出される。 The method initializeEventListeners() will be called by the User Agent before the onload event is triggered.

他のバイナリ・プログラミング言語に対するイベント・バインディングは定められていない。 The event binding of other binary programming languages is not specified.

付録 D: Java 言語バインディング

目次

D.1 Java 言語バインディング

D.2 Java 言語による SVG の利用