<?xml version="1.0" encoding="Shift_JIS"?>

<document>

    <properties>
        <title>ImportTool</title>
        <author email="marino@apache.org">Marino A. Jonsson</author>
        <projectfile>xdocs-ja/view/menu.xml</projectfile>
        <translator email="shinobu@ieee.org">Shinobu Kawai</translator>
        <translator email="nekop@programmers.jp">木村 貴由</translator>
        <original>ImportTool</original>
     </properties>

    <body>

    <section name="ImportTool Reference Documentation" alias="ImportTool リファレンスドキュメント">

        <primary>
        <p>General-purpose text-importing view tool for templates.</p>
        </primary>
        <p>テキストをインポートする、テンプレートのための汎用的なビューツールです。</p>

        <toolinfo>
            <version>@@@version@@@, @@@date@@@</version>
            <clazz>org.apache.velocity.tools.view.tools.ImportTool</clazz>
            <name>$import</name>
            <author email="marinoj@centrum.is">Marino A. Jonsson</author>
            <config-example>&lt;tool&gt;
  &lt;key&gt;import&lt;/key&gt;
  &lt;scope&gt;session&lt;/scope&gt;
  &lt;class&gt;org.apache.velocity.tools.view.tools.ImportTool&lt;/class&gt;
&lt;/tool&gt;</config-example>
        </toolinfo>

        <methods/>

    </section>


    <section name="read()">
        <primary>
        <method name="read()">

            <abstract>
                Returns the supplied URL rendered as a String.
            </abstract>

            <signature>
                String read(String url)
            </signature>

            <parameters>
                <parameter name="url">
                    The URL to import.
                </parameter>
            </parameters>

            <returns>
                The supplied URL rendered as a String.
            </returns>

            <description>
                <p>This method takes an arbitrary URL or URI and renders it as a String.
                This tool can also be used to import local .vm resources without sharing
                the current velocity-context (as opposed to the #parse directive).</p>

<sourcecode>$import.read("http://jakarta.apache.org/velocity/tools")
$import.read("/wookie.jsp")</sourcecode>
		</description>
            </method>
        </primary>
        <method name="read()">

            <abstract>
                与えられたURLが示すリソースを文字列に変換して返却します。
            </abstract>

            <signature>
                String read(String url)
            </signature>

            <parameters>
                <parameter name="url">
                    インポート対象のURL。
                </parameter>
            </parameters>

            <returns>
                与えられたURLが示すリソースを文字列に変換した結果。
            </returns>

            <description>
                <p>このメソッドは任意のURLまたはURIが示すリソースを文字列に変換します。
                このツールはローカルの.vmリソースをインポートするためにも使用できます。
                この際、(#parse指示子とは反対に)カレントのvelocityコンテキストは共有されません。</p>

<sourcecode>$import.read("http://jakarta.apache.org/velocity/tools")
$import.read("/wookie.jsp")</sourcecode>
		</description>
            </method>
    </section>
 </body>
</document>


