[jboss-cvs] JBossAS SVN: r99096 - in projects/docs/enterprise/5.0/RESTEasy: ja-JP and 1 other directory.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Thu Jan 7 01:38:14 EST 2010
Author: mospina
Date: 2010-01-07 01:38:13 -0500 (Thu, 07 Jan 2010)
New Revision: 99096
Added:
projects/docs/enterprise/5.0/RESTEasy/ja-JP/
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Async_job_service.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Asynchronous_HTTP.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Atom.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Author_Group.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Book_Info.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Cache_NoCache_CacheControl.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Configuring_Individual_JAX-RS_Resource_Beans.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Content_Marshalling_Providers.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/ExceptionMappers.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Guice1.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Installation_Configuration.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Interceptors.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Content_Negotiation.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Resource_Locators_and_Sub_Resources.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/JBoss.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Jaxb.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Json.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Maven_and_RESTEasy.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Migration_from_older_versions.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Multipart.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Overview.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Preface.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Client_Framework.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_EJB_Integration.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Embedded_Container.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Reference_Guide.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Server-side_Mock_Framework.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Spring_Integration.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Responses_using_coreResponse.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Revision_History.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Securing_JAX-RS_and_RESTeasy.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/StringConverter.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Using_Path.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/Yaml.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Context.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_CookieParam.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_DefaultValue.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Encoded_and_encoding.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Form.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_FormParam.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_HeaderParam.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_MatrixParam.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_PathParam.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/_QueryParam.po
projects/docs/enterprise/5.0/RESTEasy/ja-JP/gzip.po
Log:
PO files updated
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Async_job_service.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Async_job_service.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Async_job_service.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,94 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:57\n"
+"PO-Revision-Date: 2010-01-07T06:35:57\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Asynchronous Job Service"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The RESTEasy Asynchronous Job Service is an implementation of the Asynchronous Job pattern defined in O'Reilly's <citetitle>Restful Web Services</citetitle>. It is designed to add asynchronicity to a synchronous protocol."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Using Async Jobs"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "While HTTP is a synchronous protocol, it is capable of dealing with asynchronous invocations. The HTTP 1.1 response code <literal>202</literal> (Accepted) means that the server has received and accepted the response for processing, but that processing is not yet complete. The RESTEasy Asynchronous Job Service is based on this type of response."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For example, if you make the above post with the <literal>asynch</literal> query parameter set to <literal>true</literal>, RESTEasy returns a <literal>202</literal> (Accepted) response code and runs the invocation in the background. It also returns a Location header with a URL pointing to the location of the background method's response."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The URI will have the form of:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can perform <literal>GET</literal>, <literal>POST</literal> and <literal>DELETE</literal> operations on this job URL. <literal>GET</literal> returns the response of the JAX-RS resource method, if the job has completed. If the job has not completed, this <literal>GET</literal> returns a response code of <literal>202</literal> (Accepted). Invoking <literal>GET</literal> does not remove the job, so it can be called multiple times. When RESTEasy's job queue becomes full, it will evict the least recently used job from memory. You can clean the queue manually by calling <literal>DELETE</literal> on the URI. <literal>POST</literal> reads the <literal>JOB</literal> response and removes the <literal>JOB</literal> when it has completed."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Both <literal>GET</literal> and <literal>POST</literal> let you specify a mazimum wait time in milliseconds — a <literal>wait</literal> query parameter. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you do not specify a <literal>wait</literal> parameter, the <literal>GET</literal> or <literal>POST</literal> will not wait at all if the job is not complete."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "While you can invoke <literal>GET</literal>, <literal>DELETE</literal>, and <literal>PUT</literal> methods asynchronously, this breaks the HTTP 1.1 contract of these methods. These invocations may not change the state of the resource if invoked more than once, but they do change the state of the server. Try to invoke POST methods asynchronously."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Security in the Asynchronous Job Service"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy role-based security (annotations) does not work with the Asynchronous Job Service. <emphasis>You must use XML declarative security within your <filename>web.xml</filename> file.</emphasis> It is currently impossible to implement role-based security portably. In the future, we may have specific JBoss integration, but will not support other environments."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Oneway: Fire and Forget"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy also supports the notion of <emphasis>fire and forget</emphasis>. This returns a <literal>202</literal> (Accepted) response, but no Job is created. Use the <literal>oneway</literal> query parameter instead of <literal>asynch</literal>, like so:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Setup and Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The Asynchronous Job Service is not enabled by default, so you will need to enable it in your <filename>web.xml</filename>:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Asynchronous_HTTP.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Asynchronous_HTTP.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Asynchronous_HTTP.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,94 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Asynchronous HTTP Request Processing"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Asynchronous HTTP Request Processing lets you process a single HTTP request using NIO (Non-blocking Input/Output), in separate threads (if desired). This is also known as <emphasis>COMET capability</emphasis>. The primary use case for Asynchronous HTTP is where the client polls the server for a delayed response."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A common example is an AJAX chat client that pushes/pulls from both the client and the server. In this scenario, the client blocks a long period of time on the server's socket while waiting for a new message. In synchronous HTTP (where the server blocks on incoming and outgoing I/O), one thread is consumed per client connection, which consumes both memory and thread resources. When multiple concurrent clients block in this way, resources are not used effectively, and the server does not scale well."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Tomcat, Jetty, and JBoss Web all have similar (proprietary) support for asynchronous HTTP request processing. This functionality is currently being standardized in the Servlet 3.0 specification. RESTEasy provides a simple callback API to provide asynchronous capabilities, and supports integration with Servlet 3.0 (through Jetty 7), Tomcat 6, and JBoss Web 2.1.1."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The RESTEasy asynchronous HTTP support is implemented via two classes: the <literal>@Suspend</literal> annotation and the <literal>AsynchronousResponse</literal> interface."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Suspend</literal> tells RESTEasy that the HTTP request/response should be detached from the currently executing thread, and that the current thread should not automatically process the response. The argument to <literal>@Suspend</literal> is the time in milliseconds until the request should be cancelled."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>AsynchronousResponse</literal> is the callback object. It is injected into the method by RESTEasy. Application code moves the <literal>AsynchronousResponse</literal> to a different thread for processing. Calling <literal>setResponse()</literal> returns a response to the client and terminates the HTTP request. The following is an example of asynchronous processing:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Tomcat 6 and JBoss 4.2.3 Support"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To use RESTEasy's Asynchronous HTTP APIs with Tomcat 6 or JBoss 4.2.3, you must use a special RESTEasy Servlet and configure Tomcat (or JBoss Web in JBoss 4.2.3) to use the NIO transport. First, edit Tomcat's (or JBoss Web's) <filename>server.xml</filename> file. Comment out the <literal>vanilla HTTP adapter</literal> and add the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Your deployed RESTEasy applications must also use a different RESTEasy Servlet: <literal>org.jboss.resteasy.plugins.server.servlet.Tomcat6CometDispatcherServlet</literal>. This class is available within the <filename>async-http-tomcat-xxx.jar</filename> (or within the Maven repository, under the <literal>async-http-tomcat6</literal> artifact ID) in <filename>web.xml</filename>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Servlet 3.0 Support"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As of October 20th, 2008, only Jetty 7.0.pre3 (mortbay.org) supported the current draft of the unfinished Servlet 3.0 specification."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Your deployed RESTEasy applications must also use a different RESTEasy Servlet: <literal>org.jboss.resteasy.plugins.server.servlet.HttpServlet30Dispatcher</literal>. This class is available within the <filename>async-http-servlet-3.0-xxx.jar</filename> (or within the Maven repository under the <literal>async-http-servlet-3.0</literal> artifact ID) in <filename>web.xml</filename>:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JBossWeb, JBoss AS 5.0.x Support"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The JBossWeb container is shipped with JBoss AS 5.0.x and higher requires the JBoss Native plugin to enable asynchronous HTTP processing. See the JBoss Web documentation for information about this process."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Your deployed RESTEasy applications must use a different RESTEasy Servlet: <literal>org.jboss.resteasy.plugins.server.servlet.JBossWebDispatcherServlet</literal>. This class is available within the <filename>async-http-jbossweb-xxx.jar</filename> (or within the Maven repository under the <literal>async-http-jbossweb</literal> artifact ID) in <filename>web.xml</filename>:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Atom.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Atom.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Atom.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,104 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "RESTEasy Atom Support"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Atom is an XML-based document format that compiles lists of related information, known as <emphasis>feeds</emphasis>. Feeds are composed of a number of items, known as <emphasis>entries</emphasis>, each of which includes an extensible set of metadata (a title, for example)."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Atom is primarily used to syndicate web content (such as weblogs and news headlines) to websites, and directly to user agents."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Atom is the RSS feed of the next generation. Although used primarily to syndicate weblogs and news, the format is starting to be used as the envelope for Web services such as distributed notifications and job queues, or simply to send or receive data in bulk to or from a service."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "RESTEasy Atom API and Provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has defined a simple object model to represent Atom in Java, and uses JAXB to marshal and unmarshal it. The <literal>org.jboss.resteasy.plugins.providers.atom</literal> package contains the main classes: <classname>Feed</classname>, <classname>Entry</classname>, <classname>Content</classname>, and <classname>Link</classname>. Each class is annotated with JAXB annotations. The distribution also contains the JavaDocs for this project, which are very useful in learning the model. The following code is a simple example of sending an Atom feed with the RESTEasy API:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy's Atom provider is JAXB-based, so you are not limited to sending Atom objects with XML. You can automatically re-use RESTEasy's other JAXB providers (JSON and FastinfoSet). All you need to do is add <literal>+atom</literal> in front of the main subtype (that is, <code>@Produces(\"application/atom+json\")</code> or <code>@Consumes(\"application/atom+fastinfoset\")</code>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Using JAXB with the Atom Provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <classname>org.jboss.resteasy.plugins.providers.atom.Content</classname> class lets you marshal and unmarshal JAXB-annotated objects that form the body of an entry's content. The following code is an example of sending an <literal>Entry</literal> with a <literal>Customer</literal> object attached as the body of the entry's content."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>Content.setJAXBObject()</literal> method tells the content object that you are returning a Java JAXB object to be marshalled. If you use a base format other than XML (for example, <literal>application/atom+json</literal>), the attached JAXB object will be marshalled into that format."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If your input is an Atom document, you can also extract JAXB objects from <literal>Content</literal> by using <code>Content.getJAXBObject(Class clazz)</code>. The code that follows is an example of extracting a <literal>Customer</literal> object from the <literal>Content</literal>:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Atom support through Apache Abdera"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy supports Apache Abdera, an implementation of the Atom protocol and data format. You can find Abdera at the <ulink url=\"http://incubator.apache.org/abdera/\">Apache web site</ulink>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Abdera is a fully-fledged Atom server, but RESTEasy only supports integration with JAX-RS for marshalling and unmarshalling the Atom data format to and from the <classname>Feed</classname> and <classname>Entry</classname> interface types in Abdera."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Abdera and Maven"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The Abdera provider is not included with the RESTEasy distribution. To include the Abdera provider in your WAR archive's <filename>pom</filename> files, add the following. Remember to change the version in the code to the version of RESTEasy that you are working with."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy may not pick up the latest version of Abdera."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Using the Abdera Provider"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Author_Group.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Author_Group.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Author_Group.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,14 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Book_Info.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Book_Info.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Book_Info.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,24 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "RESTEasy Reference Guide"
+msgstr ""
+
+#. Tag: subtitle
+#, no-c-format
+msgid "for Use with JBoss Enterprise Application Platform"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Cache_NoCache_CacheControl.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Cache_NoCache_CacheControl.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Cache_NoCache_CacheControl.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,99 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "RESTEasy Caching Features"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides a number of annotations to support HTTP caching semantics, to simplify processes such as setting Cache-Control headers, and to make both server-side and client-side in-memory caches available."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "@Cache and @NoCache Annotations"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides an extension to JAX-RS that lets you set <literal>Cache-Control</literal> headers on successful GET requests. It can only be used on methods annotated with <literal>@GET</literal>. Successful get requests return a response of <literal>200 OK</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Cache</literal> builds a complex <literal>Cache-Control</literal> header; <literal>@NoCache</literal> specifies that you do not want anything to be cached. (That is, <literal>Cache-Control: nocache</literal>.)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can place these annotations on the resource class or interface, or place them on each individual <literal>@GET</literal> resource method. They specify a default cache value for each <literal>@GET</literal> resource method."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Client \"Browser\" Cache"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy can create a client-side, browser-like cache for use with the Client Proxy Framework or with raw <literal>ClientRequest</literal>s. This cache locates <literal>Cache-Control</literal> headers that are returned with a server response. If the <literal>Cache-Control</literal> headers specify that the client may cache the response, RESTEasy caches it within local memory. This cache obeys <literal>max-age</literal> requirements, and automatically performs HTTP 1.1 cache revalidation if either or both of the <literal>Last-Modified</literal> or <literal>ETag</literal> headers are returned with the original response. (See the HTTP 1.1 specification for details about <literal>Cache-Control</literal> or cache revalidation.)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Enabling RESTEasy caching is simple. The following shows the client cache being used with the Client Proxy Framework:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can create a proxy for this interface and enable caching for that proxy like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you are using the <literal>ClientRequest</literal> class instead of the proxy server to perform invocations, you can enable the cache like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "By default, the <literal>LightweightBrowserCache</literal> has a maximum caching space of two megabytes. You can change this programmatically by calling the <literal>setMaxBytes()</literal> method. <emphasis>If the cache becomes full, all cached data will be deleted automatically.</emphasis> For more complex caching solutions, or support for third-party cache options, contact the resteasy-development list and discuss your ideas with the community. <!-- #modify: mailto? -->"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Local Server-Side Response Cache"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has a local, server-side, in-memory cache for your JAX-RS services. It automatically caches marshalled responses from HTTP GET JAX-RS invocations if your JAX-RS resource method sets a <literal>Cache-Control</literal> header. When a GET is received, the RESTEasy Server Cache checks whether the URI is stored in the cache. If true, the marshalled response is returned without invoking your JAX-RS method. Each cache entry has a <emphasis>maximum age</emphasis> for which the specifications in the <literal>Cache-Control</literal> header of the initial request are valid. The cache also automatically generates an <literal>ETag</literal> using an MD5 hash on the response body. This lets the client perform HTTP 1.1 cache revalidation with the <literal>IF-NONE-MATCH</literal> header. The cache will also perform revalidation if there is no initial cache hit, but the JAX-RS method returns a body with the same <literal>ETag</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To set up the server-side cache with Maven, you must use the <literal>resteasy-cache-core</literal> artifact:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Next, add a <literal>ServletContextListener</literal>: <literal>org.jboss.resteasy.plugins.cache.server.ServletServerCache</literal>. You must specify this after the <literal>ResteasyBootstrap</literal> listener in your <filename>web.xml</filename> file."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The cache implementation is based on the <ulink url=\"http://jboss.org/jbosscache\">JBoss Cache project</ulink>. You can set two <literal>context-param</literal> configuration variables: <literal>resteasy.server.cache.maxsize</literal> sets the number of elements that can be cached, and <literal>resteasy.server.cache.eviction.wakeup.interval</literal> sets the rate at which the background eviction thread runs to purge the cache of stale entries."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Configuring_Individual_JAX-RS_Resource_Beans.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Configuring_Individual_JAX-RS_Resource_Beans.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Configuring_Individual_JAX-RS_Resource_Beans.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,44 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Configuring Individual JAX-RS Resource Beans"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you scan your path for JAX-RS annotated resource beans, your beans are registered in <emphasis>per-request mode</emphasis>. This means that an instance will be created for every HTTP request served. You will usually require information from your environment. If you run a <filename>WAR</filename> in a Servlet container with Beta 2 or lower, you can only use JNDI lookups to obtain references to Java EE resources and configuration information. In this case, define your EE configuration (that is, <literal>ejb-ref</literal>, <literal>env-entry</literal>, <literal>persistence-context-ref</literal>, etc.) in the <filename>web.xml</filename> of your RESTEasy <filename>WAR</filename> file. Then, within your code, perform JNDI lookups in the <literal>java:comp</literal> namespace. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<filename>web.xml</filename>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<emphasis>Resource Code:</emphasis>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can also configure and register your beans manually through the Registry. In a <filename>WAR</filename>-based deployment, you must write a specific <literal>ServletContextListener</literal> to do this. The listener lets you obtain a reference to the Registry, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We recommend investigating Spring Integration and the Embedded Container's Spring Integration for a full understanding of this process."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Content_Marshalling_Providers.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Content_Marshalling_Providers.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Content_Marshalling_Providers.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,129 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Content Marshalling/Providers"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Default Providers and default JAX-RS Content Marshalling"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy can automatically marshal and unmarshal several different message body types."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Message Body Types"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Media Types"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Java Type"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "application/*+xml, text/*+xml, application/*+json, application/*+fastinfoset, application/atom+*"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "JaxB annotated classes"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "*/*"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "java.lang.String"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "java.io.InputStream"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "text/plain"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "primitives, java.lang.String, or any type that has a String constructor, or static valueOf(String) method for input, toString() for output"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "javax.activation.DataSource"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "java.io.File"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "byte[]"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "application/x-www-form-urlencoded"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "javax.ws.rs.core.MultivaluedMap"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Content Marshalling with @Provider classes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The JAX-RS specification lets you plug in your own readers and writers for request or reponse bodies. To do so, annotate a class with <literal>@Provider</literal> and specify the <literal>@Produces</literal> types for a reader. You must also implement a <literal>MessageBodyReader</literal> and a <literal>MessageBodyWriter</literal> interface. <!-- #modify Example! What example! Removing description of invisible example as well. -->"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Providers Utility Class"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>javax.ws.rs.ext.Providers</literal> is a simple injectable interface that lets you locate <literal>MessageBodyReader</literal>s, <literal>MessageBodyWriter</literal>s, <literal>ContextResolver</literal>s and <literal>ExceptionMapper</literal>s. It also lets you implement multi-part providers (content types that embed other content types)."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can inject an instance of <literal>Providers</literal> into <literal>MessageBodyReader</literal> or <literal>MessageBodyWriter</literal> like so:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/ExceptionMappers.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/ExceptionMappers.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/ExceptionMappers.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,204 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Exception Handling"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Exception Mappers"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>ExceptionMapper</literal>s are custom, application-provided components that can catch application exceptions and write specific HTTP responses. They are associated with <literal>@Provider</literal>, and implement the following interface:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When an application throws an exception, the exception is caught by the JAX-RS runtime. JAX-RS then scans registered <literal>ExceptionMapper</literal>s to locate one which supports marshalling the exception type thrown. An example <literal>ExceptionMapper</literal> follows:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>ExceptionMapper</literal>s are registered in the same way as <literal>MessageBodyReader</literal>s and <literal>MessageBodyWriter</literal>s: by scanning through the RESTEasy provider <literal>context-param</literal> (if you are deploying in a <filename>WAR</filename> file), or programmatically through the <literal>ResteasyProviderFactory</literal> class."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "RESTEasy Built-in Internally-Thrown Exceptions"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has a set of built-in exceptions that are thrown when an error is encountered during dispatching or marshalling. Each exception matches a specific HTTP error code. The full list is available in the RESTEasy Java Documentation, under the <literal>org.jboss.resteasy.spi</literal> package. The following table lists the most common exceptions:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Common Exceptions"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Exception"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "HTTP Code"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>BadRequestException</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "400"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Bad Request. Request was not formatted correctly or there was a problem processing request input."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>UnauthorizedException</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "401"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Unauthorized. Security exception thrown if you use RESTEasy's simple annotation- and role-based security."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>InternalServerError</exceptionname> <exceptionname>Exception</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "500"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Internal Server Error."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>MethodNotAllowed</exceptionname> <exceptionname>Exception</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "405"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Method Not Allowed. There is no JAX-RS method for the resource that can handle the invoked HTTP operation."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>NotAcceptableException</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "406"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Not Acceptable. There is no JAX-RS method that can produce the media types listed in the Accept header."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>NotFoundException</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "404"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Not Found. There is no JAX-RS method that serves the request path/resource."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>Failure</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "N/A"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Internal RESTEasy. Not logged."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>LoggableFailure</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Internal RESTEasy error. Logged."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<exceptionname>DefaultOptionsMethod</exceptionname> <exceptionname>Exception</exceptionname>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "If the user invokes HTTP OPTIONS without a JAX-RS method, RESTEasy provides a default behavior by throwing this exception."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Overriding Resteasy Builtin Exceptions"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can override RESTEasy built-in exceptions by writing an <literal>ExceptionMapper</literal> for the exception. You can also write an <literal>ExceptionMapper</literal> for any exception thrown, including <literal>WebApplicationException</literal>."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Guice1.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Guice1.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Guice1.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,39 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Guice 1.0 Integration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy does have some basic integration with Guice 1.0. RESTEasy scans a Guice Module's binding types for <literal>@Path</literal> and <literal>@Provider</literal> annotations, and registers these bindings. The <literal>guice-hello</literal> project that comes in the RESTEasy <filename>examples/</filename> directory gives a nice example of this."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Start by specifying a JAX-RS resource class — in this case, the <literal>HelloResource</literal>. Next, create a Guice Module class that defines your bindings:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Place these classes within your <filename>WAR WEB-INF/classes</filename> or in a <filename>JAR</filename> within <filename>WEB-INF/lib</filename>. Then, create your <filename>web.xml</filename> file. You will need to use the <literal>GuiceResteasyBootstrapServletContextListener</literal> like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>GuiceResteasyBootstrapServletContextListener</literal> is a subclass of <literal>ResteasyBootstrap</literal>, so you can use any other RESTEasy configuration option within your <filename>web.xml</filename> file. Also note the <literal>resteasy.guice.modules</literal> context parameter. This can take a comma delimited list of class names that are Guice Modules."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Installation_Configuration.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Installation_Configuration.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Installation_Configuration.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,309 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Installation/Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy is deployed as a <filename>WAR</filename> archive, so it must be deployed inside a Servlet container."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Download and unzip the RESTEasy package from <ulink url=\"http://sourceforge.net/projects/resteasy/files/\">SourceForge</ulink>. The unzipped package contains an exploded <filename>WAR</filename>. Make a deep copy of the <filename>WAR</filename> archive for use with your particular application."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Place your JAX-RS annotated class resources and providers in one or more <filename>JAR</filename>s within <literal>/WEB-INF/lib</literal>. Alternatively, place your raw class files within <literal>/WEB-INF/classes</literal>. By default, RESTEasy is configured to scan <filename>JAR</filename>s and classes within these directories for JAX-RS annotated classes, and to deploy and register them within the system."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy is implemented as a <literal>ServletContextListener</literal> and a Servlet, and deployed within a <filename>WAR</filename> file. The <filename>WEB-INF/web.xml</filename> file contains the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<programlisting> <web-app> <display-name>Archetype Created Web Application</display-name> <!-- Set this if you want Resteasy to scan for JAX-RS classes <context-param> <param-name>resteasy.scan</param-name> <param-value>true</param-value> </context-param> --> <!-- set this if you map the Resteasy servlet to something other than /* <context-param> <param-name>resteasy.servlet.mapping.prefix</param-name> <param-value>/resteasy</param-value> </context-param> --> <!-- to turn on security <context-param> <param-name>resteasy.role.based.security</param-name> <param-value>true</param-value> </context-param> --> <listener> <listener-class>org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap</listener-class> </listener> <servlet> <servlet-name>Resteasy</servlet-name> <servlet-class&g!
t;org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class> </servlet> <servlet-mapping> <servlet-name>Resteasy</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping> </web-app> </programlisting>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>ResteasyBootstrap</literal> listener initializes some of RESTEasy's basic components and scans for annotation classes that exist in your <filename>WAR</filename> file. It also receives configuration options from <literal><context-param></literal> elements."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "These configuration options must be set if your <literal>servlet-mapping</literal> for the RESTEasy Servlet has a URL pattern other than <literal>/*</literal>. For example, if the URL pattern is:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Then the value of <literal>resteasy-servlet.mapping.prefix</literal> must be:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The available options are outlined in the table following."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Servlet Mapping Prefix Options"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Option Name"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Default Value"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.servlet.mapping</literal> <literal>.prefix</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "no default"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Defines the URL pattern for the RESTEasy <literal>servlet-mapping</literal>, if not <literal>/*.</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.scan.providers</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "false"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Scans for <literal>@Provider</literal> classes and registers them."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.scan.resources</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Scans for JAX-RS resource classes."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.scan</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Scans for both <literal>@Provider</literal> and JAX-RS resource classes (<literal>@Path</literal>, <literal>@GET</literal>, <literal>@POST</literal>, etc.) and registers them."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.providers</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "A comma-delimited list of fully-qualified <literal>@Provider</literal> class names you want to register."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.use.builtin</literal> <literal>.providers</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "true"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Determines whether default, built-in <literal>@Provider</literal> classes are registered. This option is available only in version 1.0-beta-5 and later."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.resources</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "A comma-delimited list of fully-qualified JAX-RS resource class names you want to register."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>resteasy.jndi.resources</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "A comma-delimited list of JNDI names referencing the objects that you want to register as JAX-RS resources."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>javax.ws.rs.core</literal> <literal>.Application</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Fully-qualified name of the Application class to bootstrap in a spec portable way"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>ResteasyBootstrap</literal> listener configures an instance of the <literal>ResteasyProviderFactory</literal> and <literal>Registry</literal>. You can obtain <literal>ResteasyProviderFactory</literal> and <literal>Registry</literal> instances from the <literal>ServletContext</literal> attributes <literal>org.jboss.resteasy.spi.ResteasyProviderFactory</literal> and <literal>org.jboss.resteasy.spi.Registry</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "javax.ws.rs.core.Application"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>javax.ws.rs.core.Application</literal> is a standard JAX-RS class that can be implemented to provide information about your deployment. It is a class that lists all JAX-RS root resources and providers."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To use Application you must set the Servlet <literal>context-param</literal>, <literal>javax.ws.rs.core.Application</literal>, with a fully-qualified class that implements Application. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<programlisting> <context-param> <param-name>javax.ws.rs.core.Application</param-name> <param-value>com.mycom.MyApplicationConfig</param-value> </context-param> </programlisting>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you have this set, you should probably turn off automatic scanning as this will probably result in duplicate classes being registered."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "RESTEasyLogging"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy logs various events using <application>slf4j</application>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The slf4j API is intended to serve as a simple facade for various logging APIs, allowing you to plug in the desired implementation at deployment time. By default, RESTEasy is configured to use <application>Apache log4j</application>, but you can use any logging provider supported by slf4j."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The initial set of logging categories defined in the framework is listed below. Further logging categories are being added, but these should make it easier to troubleshoot issues."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Logging Categories"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Category"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Function"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>org.jboss.resteasy.core</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Logs all activity by the core RESTEasy implementation."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>org.jboss.resteasy.plugins.providers</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Logs all activity by RESTEasy entity providers."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>org.jboss.resteasy.plugins.server</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Logs all activity by the RESTEasy server implementation."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>org.jboss.resteasy.specimpl</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Logs all activity by JAX-RS implementing classes."
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "<literal>org.jboss.resteasy.mock</literal>"
+msgstr ""
+
+#. Tag: entry
+#, no-c-format
+msgid "Logs all activity by the RESTEasy mock framework."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you are developing RESTEasy code, the <literal>LoggerCategories</literal> class provides easy access to category names and the various loggers."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Interceptors.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Interceptors.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Interceptors.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,224 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Interceptors"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy can intercept JAX-RS invocations and route them through listener-like objects called <emphasis>interceptors</emphasis>. There are four interception points on the server side:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "wrapping around <literal>MessageBodyWriter</literal> invocations"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "wrapping around <literal>MessageBodyReader</literal> invocations"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "through <emphasis>pre-processors</emphasis>, which intercept the incoming request before unmarshalling occurs"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "through <emphasis>post-processors</emphasis>, which are invoked immediately after the JAX-RS method finishes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can also intercept <literal>MessageBodyReader</literal>, <literal>MessageBodyWriter</literal>, and the remote invocation to the server on the client side."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "MessageBodyReader/Writer Interceptors"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>MessageBodyReader</literal> and <literal>MessageBodyWriter</literal> interceptors wrap around the invocation of <literal>MessageBodyReader.readFrom()</literal> or <literal>MessageBodyWriter.writeTo()</literal>. They are used to wrap the <literal>Output</literal> or <literal>InputStream</literal>. For example, RESTEasy GZIP support contains interceptors that create and override the default <literal>Output</literal> and <literal>InputStream</literal> with a <literal>GzipOutputStream</literal> or <literal>GzipInputStream</literal> so that GZIP encoding can work. You can also use interceptors to append headers to the response (or, on the client side, the outgoing request)."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To use an interceptor, implement the <literal>org.jbos.resteasy.spi.interception.MessageBodyReaderInterceptor</literal> or <literal>MessageBodyWriterInterceptor</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Interceptors are driven by the <literal>MessageBodyWriterContext</literal> or <literal>MessageBodyReaderContext</literal>. They are invoked together in a Java call stack. You must call <literal>MessageBodyReaderContext.proceed()</literal> or <literal>MessageBodyWriterContext.proceed()</literal> to add subsequent interceptors. When there are no more interceptors to invoke, call the <literal>readFrom()</literal> or <literal>writeTo()</literal> method of the <literal>MessageBodyReader</literal> or <literal>MessageBodyWriter</literal>. This wrapping lets you modify objects before they reach the Reader or Writer, and clean up when <literal>proceed()</literal> returns. The <literal>Context</literal> objects also posess methods that modify the parameters sent to the Reader or Writer."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>MessageBodyReaderInterceptor</literal>s and <literal>MessageBodyWriterInterceptor</literal>s can be use on the server or the client side. They must be annotated with <literal>@org.jboss.resteasy.annotations.interception.ServerInterceptor</literal> or <literal>@org.jboss.resteasy.annotations.interception.ClientInterceptor</literal> so that RESTEasy adds them to the correct interceptor list. If your interceptor classes are not annotated with one or both of these annotations, a deployment error will occur. Interceptors should also be annotated with <literal>@Provider</literal>, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This is a server-side interceptor that adds a header value to the response. It is annotated with <literal>@Provider</literal> and <literal>@ServerInterceptor</literal>. It must modify the header before calling <literal>context.proceed()</literal>, because the response may be committed after the <literal>MessageBodyReader</literal> runs."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You must call <literal>context.proceed()</literal>, or your invocation will not occur."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "PreProcessInterceptor"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>org.jboss.resteasy.spi.interception.PreProcessInterceptor</literal> runs after a JAX-RS resource method is located, but before the method is invoked. They can only be used on the server, but you must still annotate them with <literal>@ServerInterceptor</literal>. They can be used to implement security features or to preempt the Java request. The RESTEasy security implementation uses these interceptors to abort requests prior to invocation if the user does not pass authorization. The RESTEasy caching framework uses them to return cached responses, to avoid invoking methods multiple times. The interceptor interface is as follows:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>PreProcessInterceptor</literal>s run in sequence and do not wrap the actual JAX-RS invocation. To illustrate:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If the <literal>preProcess()</literal> method returns a <literal>ServerResponse</literal> then the underlying JAX-RS method will not be invoked and the runtime will process the response and return to the client."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "PostProcessInterceptors"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>org.jboss.resteasy.spi.interception.PostProcessInterceptor</literal> runs after the JAX-RS method is invoked but before <literal>MessageBodyWriter</literal>s are invoked. They can only be used on the server side, and exist to provide symmetry with <literal>PreProcessInterceptor</literal>. They are used to set response headers when there is a possibility that no <literal>MessageBodyWriter</literal> will be invoked. They do not wrap any object, and are invoked in order, like <literal>PreProcessInterceptor</literal>s."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "ClientExecutionInterceptors"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>org.jboss.resteasy.spi.interception.ClientExecutionInterceptor</literal> classes are client-side only. They run after the <literal>MessageBodyWriter</literal>, and after the <literal>ClientRequest</literal> has been built on the client side. They wrap the HTTP invocation that is sent to the server. In RESTEasy GZIP support, they set the <literal>Accept</literal> header to contain <literal>gzip, deflate</literal> before the request is sent. In the RESTEasy client cache, they check that the cache contains a resource before attempting to act on a resource. These interceptors must be annotated with both <literal>@ClientInterceptor</literal> and <literal>@Provider</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "They work similarly to <literal>MessageBodyReader</literal> in that you must call <literal>proceed()</literal> or the invocation will be aborted."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Binding Interceptors"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "By default, any registered interceptor will be invoked for every request. You can alter this by having your interceptors implement the <literal>org.jboss.resteasy.spi.AcceptedByMethod</literal> interface:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If your interceptor implements this interface, RESTEasy invokes the <literal>accept()</literal> method. If this method returns <literal>true</literal>, RESTEasy adds that interceptor to the JAX-RS method's call chain. If it returns <literal>false</literal>, the interceptor will not be added to the call chain. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In this example, the <literal>accept()</literal> method checks whether the <literal>@GET</literal> annotation exists in the JAX-RS method. If it does, the interceptor will be applied to that method's call chain."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Registering Interceptors"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When your interceptors are annotated as <literal>@Provider</literal>s, they can be listed in the <literal>resteasy.providers context-param</literal> in <filename>web.xml</filename>, or returned as a class or object in the <literal>Application.getClasses()</literal> or <literal>Application.getSingletons()</literal> method."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Interceptor Ordering and Precedence"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Some interceptors are sensitive to the order in which they are invoked. For example, your security interceptor should always be invoked first. Other interceptors' behavior can be triggered by an interceptor that adds a header. By default, you have no control over the order in which registered interceptors are invoked, but you can specify interceptor <emphasis>precedence</emphasis>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Interceptor precedence is not specified by listing interceptor classes. Instead, a particular interceptor class is associated with a <emphasis>precedence family</emphasis> with the <literal>@org.jboss.resteasy.annotations.interception.Precedence</literal> annotation. Specifying precedence through a family structure protects the built-in interceptors that are sensitive to ordering and simplifies configuration."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The families are listed here in execution order:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Any interceptor not associated with a precedence family will be invoked last. <literal>SECURITY</literal> usually includes <literal>PreProcessInterceptor</literal>s. These should be invoked first so that as little as possible occurs prior to authorization. <literal>HEADER_DECORATOR</literal>s are interceptors that add headers to a response or an outgoing request. These are next in precedence because the added headers may affect the behavior of other interceptors. <literal>ENCODER</literal> interceptors change the <literal>OutputStream</literal>. For example, the GZIP interceptor creates a <literal>GZIPOutputStream</literal> to wrap the real <literal>OutputStream</literal> for compression. <literal>REDIRECT</literal> interceptors are usually used in <literal>PreProcessInterceptor</literal>s because they can reroute the request and bypass the JAX-RS method. <literal>DECODER</literal> interceptors wrap the <literal>InputStream</literal>. For example, the GZIP intercepto!
r decoder wraps the <literal>InputStream</literal> in a <literal>GzipInputStream</literal> instance."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To associate your custom interceptors with a particular family, annotate it with <literal>@org.jboss.resteasy.annotations.interception.Precendence annotation</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "There are convenience annotations in the <literal>org.jboss.resteasy.annotations.interception</literal> package to provide complete type safety: <literal>@DecoredPrecedence</literal>, <literal>@EncoderPrecedence</literal>, <literal>@HeaderDecoratorPrecedence</literal>, <literal>@RedirectPrecedence</literal>, and <literal>@SecurityPrecedence</literal>. Use these instead of the <literal>@Precedence</literal> annotation"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Custom Precedence"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can define your own precedence families and apply them with the <literal>@Precedence</literal> annotation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can create your own convenience annotation by using <literal>@Precedence</literal> as a meta-annotation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You must register your custom precedence, or RESTEasy will show an error at deployment time. You can register your custom precendence with the context parameters:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>resteasy.append.interceptor.precedence</literal> appends the precedence family to the list. <literal>resteasy.interceptor.before.precedence</literal> lets you specify a family for your precendence to fall ahead of. <literal>resteasy.interceptor.after.precedence</literal> lets you specify a family for your precedence to follow after. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In this <filename>web.xml</filename> file, we have defined three new precedence families: <literal>END</literal>, <literal>BEFORE_ENCODER</literal>, and <literal>AFTER_ENCODER</literal>. With this configuration, the family order would look like this:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Content_Negotiation.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Content_Negotiation.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Content_Negotiation.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,74 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "JAX-RS Content Negotiation"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The HTTP protocol has built-in content negotiation headers that allow the client and server to specify the type of content that they transfer, and the type of content they prefer to receive. The server declares content preferences via the <literal>@Produces</literal> and <literal>@Consumes</literal> headers."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Consumes</literal> is an array of media types that a particular resource or resource method consumes. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<programlisting> @Consumes(\"text/*\") @Path(\"/library\") public class Library { @POST public String stringBook(String book) {...} @Consumes(\"text/xml\") @POST public String jaxbBook(Book book) {...} </programlisting>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When a client makes a request, JAX-RS first locates all methods that match the path. It then sorts objects based on the content-type header sent by the client. If a client sends the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>stringBook()</literal> method is invoked, because it matches the default <literal>text/*</literal> media type. If the client sends XML, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Then the <literal>jaxbBook()</literal> method is invoked."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Produces</literal> is used to map a client request and match it with the client's <literal>Accept</literal> header. The <emphasis>Accept HTTP</emphasis> header is sent by the client, and defines the media types that the client prefers to receive from the server."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "So, if the client sends:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>getJSON()</literal> method would be invoked."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Consumes</literal> and <literal>@Produces</literal> can support multiple media types by presenting them in a list. The client's <literal>Accept</literal> header can also list multiple media types to receive. More specific media types are selected first. The <literal>Accept</literal> header (or <literal>@Produces</literal> or <literal>@Consumes</literal>) can also specify weighted preferences that will match requests with resource methods. (This is best explained in Section 14.1 of RFC 2616.) RESTEasy provides support for this more complex method of content negotiation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "An alternative method used by JAX-RS is a combination of media-type, content-language, and content encoding, in addition to etags, last modified headers, and other pre-conditions. This is a more complex form of content negotiation, performed programmatically by the application developer via the <literal>javax.ws.rs.Variant</literal>, <literal>VarianListBuilder</literal>, and <literal>Request</literal> objects. <literal>Request</literal> is injected using the <literal>@Context</literal> annotation. (For more information, read the JavaDoc.)"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Resource_Locators_and_Sub_Resources.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Resource_Locators_and_Sub_Resources.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/JAX-RS_Resource_Locators_and_Sub_Resources.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,59 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "JAX-RS Resource Locators and Sub Resources"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Resource classes can partially process a request and then provide another <emphasis>sub-resource</emphasis> object to process the remainder of the request. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Resource methods with a <literal>@Path</literal> annotation and no HTTP method are considered <emphasis>sub-resource locators</emphasis>. They provide an object that can process the request. In the previous example code, <literal>ShoppingStore</literal> is a root resource because its class is annotated with <literal>@Path</literal>. The <literal>getCustomer()</literal> is a sub-resource locator method."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If the client invoked the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Then the <literal>ShoppingStore.getCustomer()</literal> method would be invoked first. This method provides a <literal>Customer</literal> object that can service the request. The HTTP request will be dispatched to the <literal>Customer.get()</literal> method. Another example is:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In this request, again, first the <literal>ShoppingStore.getCustomer()</literal> method is invoked. A <literal>Customer</literal> object is returned, and the rest of the request is dispatched to the <literal>Customer.getAddress()</literal> method."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Another interesting feature of sub-resource locators is that the locator method result is dynamically processed at runtime in order to determine how the request should be dispatched. This means that the <literal>ShoppingStore.getCustomer()</literal> method does not have to declare any specific type."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In the previous example, <literal>getCustomer()</literal> returns a <literal>java.lang.Object</literal>. Per request, at runtime, the JAX-RS server will determine how to dispatch the request based on the object returned by <literal>getCustomer()</literal>. This can be useful in certain situations."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For example, say you have a class heirarchy for your customers. <literal>Customer</literal> is the abstract base, and <literal>CorporateCustomer</literal> and <literal>IndividualCustomer</literal> are subclasses. In this case, your <literal>getCustomer()</literal> method might perform a Hibernate polymorphic query without requiring any understanding of the concrete class it queries, or the content returned."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/JBoss.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/JBoss.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/JBoss.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,24 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "JBoss 5.x Integration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Resteasy 1.1.GA has no special integration with JBoss Application Server so it must be configured and installed like any other container. There are some issues though. You must make sure that there is not a copy of servlet-api-xxx.jar in your WEB-INF/lib directory as this may cause problems. Also, if you are running with JDK 6, make sure to filter out the JAXB jars as they come with JDK 6."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Jaxb.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Jaxb.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Jaxb.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,419 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "JAXB Providers"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy includes support for marshalling and unmarshalling JAXB annotated classes. Multiple JAXB Providers are included with RESTEasy to address the subtle differences between classes generated by XJC and classes that are annotated with <literal>@XmlRootElement</literal>, or work with <literal>JAXBElement</literal> classes directly."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When using the JAX-RS API in development, the provider to be invoked is selected transparently. This chapter describes the providers best-suited for a variety of configurations if you want to access the providers <emphasis>directly</emphasis>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy selects a JAXB Provider when a parameter type (return type) is an object annotated with JAXB annotations (for example, <literal>@XmlRootEntity</literal> or <literal>@XmlType</literal>), or a <literal>JAXBElement</literal>. The resource class (resource method) will be annotated with either <literal>@Consumes</literal> or <literal>@Produces</literal>, and contain one or more of the following values:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>text/*+xml</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>application/*+xml</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>application/*+fastinfoset</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>application/*+json</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy selects different providers based on the return type used in the resource. This section decribes the workings of the selection process."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Classes annotated with <literal>@XmlRootElement</literal> are handled with the <literal>JAXBXmlRootElementProvider</literal>. This provider handles basic marshalling and unmarshalling of custom JAXB entities."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Classes that are generated by XJC do not usually contain an <literal>@XmlRootElement</literal> annotation. To be marshalled, they must be wrapped in an instance of <literal>JAXBElement</literal>. This usually involves invoking a method named <literal>ObjectFactory</literal> on the class, which serves as the <literal>XmlRegistry</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>JAXBXmlTypeProvider</literal> provider is selected when the class is annotated with an <literal>XmlType</literal> annotation and not an <literal>XmlRootElement</literal> annotation. The provider attempts to locate the <literal>XmlRegistry</literal> for the target class. By default, a JAXB implementation creates a class called <literal>ObjectFactory</literal> and is located in the same package as the target class. <literal>ObjectFactory</literal> contains a <literal>create</literal> method that takes the object instance as a parameter. For example, if the target type is called <literal>Contact</literal>, then the <literal>ObjectFactory</literal> class will have a method:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If your resource works with the <literal>JAXBElement</literal> class directly, the RESTEasy runtime will select the <literal>JAXBElementProvider</literal>. This provider examines the <literal>ParameterizedType</literal> value of the <literal>JAXBElement</literal> in order to select the appropriate <literal>JAXBContext</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JAXB Decorators"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy's JAXB providers can decorate <literal>Marshaller</literal> and <literal>Unmarshaller</literal> instances. Add an annotation that triggers the decoration <literal>Marshaller</literal> or <literal>Unmarshaller</literal>. The decorators can perform tasks such as setting <literal>Marshaller</literal> or <literal>Unmarshaller</literal> properties and setting up validation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As an example, say you want to create an annotation that will trigger <emphasis>pretty-printing</emphasis> of an XML document. In raw JAXB, we would set a property on the <literal>Marshaller</literal> of <literal>Marshaller.JAXB_FORMATTED_OUTPUT</literal>. Instead, let us write a <emphasis>Marshaller decorator</emphasis>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "First, define an annotation:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For this to work, you must annotate the <literal>@Pretty</literal> annotation with a meta-annotation named <literal>@Decorator</literal>. The <literal>target()</literal> attribute must be the JAXB <literal>Marshaller</literal> class. Next, we will write the <literal>processor()</literal> attribute class."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>processor</literal> implementation must implement the <literal>DecoratorProcessor</literal> interface, and should also be annotated with <literal>@DecorateTypes</literal>. This annotation specifies the media types that the processor can work with."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now that we have defined our annotation and our <literal>Processor</literal>, we can use it on our JAX-RS resource methods or JAXB types like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If this is confusing, check the RESTEasy source code for information about implementing <literal>@XmlHeader</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Pluggable <literal>JAXBContext</literal>s with <literal>ContextResolvers</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We do not recommend using this feature unless you are familiar with the principles involved."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "By default, RESTEasy creates and caches <literal>JAXBContext</literal> instances per class type depending on the class you are marshalling or unmarshalling. If you do not want RESTEasy to create <literal>JAXBContext</literal>s, you can plug in your own by implementing an instance of <literal>javax.ws.rs.ext.ContextResolver</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You must provide a <literal>@Produces</literal> annotation to specify the types of media intended for the context. You must also implement <literal>ContextResolver<JAXBContext></literal>. This helps the runtime match the correct context resolver. You must also annotate the <literal>ContextResolver</literal> class with <literal>@Provider</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "There are several ways to make this <literal>ContextResolver</literal> available."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "return it as a class or instance from a <literal>javax.ws.rs.core.Application</literal> implementation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "list it as a provider with <literal>resteasy.providers</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "let RESTEasy automatically scan for it within your <filename>WAR</filename> file. (See the Configuration Guide for more details.)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "add it manually via <literal>ResteasyProviderFactory.getInstance().registerProvider(Class)</literal> or <literal>registerProviderInstance(Object)</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JAXB and XML provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides the required JAXB provider support for XML. It has several additional annotations to make application coding simpler."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "<literal>@XmlHeader</literal> and <literal>@Stylesheet</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To set an XML header when you output XML documents, use the <literal>@org.jboss.resteasy.annotations.providers.jaxb.XmlHeader</literal> annotation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Here, the <literal>@XmlHeader</literal> forces an <literal>xml-stylesheet</literal> header on the XML output. The same result can be obtained by placing the header on the <literal>Thing</literal> class. Read the JavaDocs for further information regarding the substitution values provided by RESTEasy."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy also has a convenient annotation for stylesheet headers. For example:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JAXB and JSON provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy lets you marshal JAXB annotated POJOs to and from JSON with the Jettison JSON library. You can find more information about Jettison at <ulink url=\"http://jettison.codehaus.org/\">http://jettison.codehaus.org/</ulink>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Jettison has two mapping formats: the default <emphasis>Jettison Mapped Convention</emphasis> format, and BadgerFish."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For example, consider this JAXB class:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The JAXB <literal>Book</literal> class would be marshalled to JSON using the BadgerFish Convention:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Element values are associated with a map. To find the value of the element, you must access the <literal>$</literal> variable. You could access the book like this, in JavaScript:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To use the BadgerFish Convention you must use the <literal>@org.jboss.resteasy.annotations.providers.jaxb.json.BadgerFish</literal> annotation either on the JAXB class you are marshalling or unmarshalling, or on the JAX-RS resource method or parameter:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To return a <literal>book</literal> on the JAX-RS method without polluting your JAXB classes with RESTEasy annotations, you can add the annotation to the JAX-RS method instead:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If your input is a <literal>Book</literal>, place it on the parameter:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The default Jettison Mapped Convention returns the following JSON:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Note that <literal>title</literal> is prefixed with the <literal>@</literal> character. Unlike the BadgerFish convention, this does not represent the value of element text, which makes it simpler (and a sensible default). To access this in JavaScript:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The Mapped Convention lets you adjust the JAXB mapping with the <literal>@org.jboss.resteasy.annotations.providers.jaxb.json.Mapped</literal> annotation. With this, you can provide an XML namespace to JSON namespace mapping. For example, if you define your JAXB namespace within your <literal>package-info.java</literal> class like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You must define a JSON-to-XML namespace mapping, or you will receive an exception:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@Mapped</literal> annotation fixes this problem. Place the <literal>@Mapped</literal> annotation on your JAXB classes, your JAX-RS resource method, or on the parameter that you are unmarshalling."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can also force <literal>@XmlAttribute</literal>s to be marshalled as <literal>XMLElements</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To return a <literal>book</literal> on the JAX-RS method without polluting your JAXB classes with RESTEasy annotations, add the annotation to the JAX-RS method:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JAXB and FastinfoSet provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy supports the <literal>Fastinfoset</literal> MIME type through the use of JAXB annotated classes. <literal>Fastinfoset</literal> documents serialize and parse more quickly, and are smaller in size, than logically-equivalent XML documents, so they can be used where size and processing time of XML documents is problematic. It is configured in the same way as the XML JAXB provider."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Arrays and Collections of JAXB Objects"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy automatically marshals arrays, <literal>java.util.Set</literal>s, and <literal>java.util.List</literal>s of JAXB objects to and from XML, JSON, <literal>Fastinfoset</literal>, and other RESTEasy JAXB mappers."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The resource above publishes and receives JAXB objects. We assume that these are wrapped in a collection element like the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can change the namespace URI, namespace tag, and collection element name by using the <literal>@org.jboss.resteasy.annotations.providers.jaxb.Wrapped</literal> annotation on a parameter or method:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "So, if we wanted to output the following XML:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We would use the <literal>@Wrapped</literal> annotation as follows:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JSON and JAXB Collections/Arrays"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy supports using collections with JSON. It encloses lists, sets, or arrays of returned JAXB objects in a simple JSON array. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A List or Array of the <literal>Foo</literal> class would be represented in JSON like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "It would also expect this format when receiving input."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Maps of JAXB Objects"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy automatically marshals maps of JAXB objects to and from XML, JSON, <literal>Fastinfoset</literal>, and other JAXB mappers. Your parameter or method return type must be generic, with a String as the key and the JAXB object's type."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This resource publishes and receives JAXB objects within a map. By default, they are wrapped in a <literal>map</literal> element in the default namespace. Each <literal>map</literal> element has zero or more <literal>entry</literal> elements with a <literal>key</literal> attribute."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can change the namespace URI, namespace prefix and map, entry, and key element and attribute names by using the <literal>@org.jboss.resteasy.annotations.providers.jaxb.WrappedMap</literal> annotation on a parameter or method."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "So, to output the following XML:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We would use the @WrappedMap annotation as follows:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "JSON and JAXB maps"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy supports the use of maps with JSON. It encloses returned JAXB objects within simple JSON maps. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This a List or array of this Foo class would be represented in JSON like this:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "It also expects this format for input"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Possible Problems with Jettison Provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you have the <filename>resteasy-jackson-provider-xxx.jar</filename> in your classpath, the Jackson JSON provider will be triggered. This is problematic for code that depends upon the Jettison JAXB or JSON provider. To correct this, you must either remove Jackson from your <literal>WEB-INF/lib</literal> or classpath, or use the <literal>@NoJackson</literal> annotation on your JAXB classes."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Interfaces, Abstract Classes, and JAXB"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Some object models use abstract classes and interfaces heavily. JAXB does not work with interfaces that are root elements, and RESTEasy cannot unmarshal parameters that are interfaces or raw abstract classes because it lacks the information required to create a <literal>JAXBContext</literal>. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In this example, RESTEasy would display an error (\"Cannot find MessageBodyReader for...\" or similar) because RESTEasy does not know that implementations of <literal>IFoo</literal> are JAXB classes, so it cannot create a <literal>JAXBContext</literal> for <literal>IFoo</literal>. As a workaround, you can annotate the interface with <literal>@XmlSeeAlso</literal> to correct the issue."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This will not work with manual, hand-coded JAXB."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The extra <literal>@XmlSeeAlso</literal> on <literal>IFoo</literal> allows RESTEasy to create a <literal>JAXBContext</literal> that knows how to unmarshal <literal>RealFoo</literal> instances."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Json.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Json.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Json.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,59 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "JSON Support via Jackson"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Apart from the Jettison JAXB adapter for JSON, RESTEasy also supports integration with the Jackson project. Many users find Jackson's output format more intuitive than the format provided by either BadgerFish or Jettison."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Jackson is available from <ulink url=\"http://jackson.codehaus.org\">http://jackson.codehaus.org</ulink>. It lets you easily marshal Java objects to and from JSON. Jackson has a JavaBean-based model and JAXB-like APIs. RESTEasy integrates with the JavaBean model as described <ulink url=\"http://jackson.codehaus.org/Tutorial\">in the Jackson Tutorial</ulink>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To include Jackson in your project, add the following Maven dependency to your build:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy expands the JAX-RS integration built into Jackson in several ways. The first expansion provided support for <literal>application/*+json</literal>. Previously, Jackson accepted only <literal>application/json</literal> and <literal>text/json</literal> as valid media types. <literal>application/*+json</literal> support lets you marshal your JSON-based media types with Jackson. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Using RESTEasy JAXB providers alongside Jackson is also problematic. Rather than use Jackson to output your JSON, you can use Jettison and JAXB. To do so, you must either not install the Jackson provider, or use the <literal>@org.jboss.resteasy.annotations.providers.NoJackson</literal> annotation on your JAXB annotated classes, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you cannot annotate the JAXB class with <literal>@NoJackson</literal>, tehn you can annotate a method parameter instead:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Possible Conflict With JAXB Provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If your Jackson classes are annotated with JAXB annotations and the <literal>resteasy-jaxb-provider</literal> is on your classpath, you can trigger the Jettison JAXB marshalling code. To disable the JAXB JSON Marshaller, annotate your classes with <literal>@org.jboss.resteasy.annotations.providers.jaxb.IgnoreMediaTypes(\"application/*+json\")</literal>."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Maven_and_RESTEasy.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Maven_and_RESTEasy.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Maven_and_RESTEasy.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,39 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Maven and RESTEasy"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The JBoss Maven repository is located at <ulink url=\"http://repository.jboss.org/maven2\">http://repository.jboss.org/maven2</ulink>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can combine them with the following <filename>pom.xml</filename> fragment. RESTEasy is divided into various components. You can mix and match components as required. Remember to replace <replaceable>1.1.GA</replaceable> with the RESTEasy version you want to use."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can also import a <filename>POM</filename> to ensure that individual module versions need not me specified."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This requires Maven 2.0.9."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Migration_from_older_versions.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Migration_from_older_versions.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Migration_from_older_versions.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,59 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Migration from older versions"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Migrating from 1.0.x and 1.1-RC1"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can expect the following changes when you migrate to the latest version of RESTEasy:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can now turn on RESTEasy's role-based security (<literal>@RolesAllowed</literal>) by using the new <literal>resteasy.role.based.security context-param</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Wrapped</literal> is now enabled by default for Lists, Arrays, and Sets of JAXB objects. You can also change the namespace and element names with this annotation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Wrapped</literal> is not enclosed in a RESTEasy namespace prefix, and now uses the default namespace instead of the <literal>http://jboss.org/resteasy</literal> namespace."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Wrapped JSON</literal> is now enclosed in a simple JSON Array."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Placing the <filename>resteasy-jackson-provider-xxx.jar</filename> in your classpath triggers the Jackson JSON provider. This can cause code errors if you had previously been using the Jettison JAXB/JSON providers. To fix this, you must either remove Jackson from your <filename>WEB-INF/lib</filename> or the classpath, or use the <literal>@NoJackson</literal> annotation on your JAXB classes."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>tjws</literal> and <literal>servlet-api</literal> artifacts are now scoped as <emphasis>provided</emphasis> in the <literal>resteasy-jar</literal> dependencies. If you have trouble with <emphasis>Class not found</emphasis> errors, you may need to scope them as <literal>provided</literal> or <literal>test</literal> in your <filename>pom</filename> files."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Multipart.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Multipart.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Multipart.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,224 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Multipart Providers"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has rich support for the <literal>multipart/*</literal> and <literal>multipart/form-data</literal> MIME (Multipurpose Internet Mail Extension) types. The <literal>multipart</literal> MIME format passes lists of content bodies. Multiple content bodies are embedded in the one message. <literal>multipart/form-data</literal> is often found in web application HTML Form documents, and is generally used to upload files. The <literal>form-data</literal> format works like other <literal>multipart</literal> formats, except that each inlined piece of content has a name associated with it."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides a custom API for reading and writing <literal>multipart</literal> types, as well as marshalling arbitrary List (for any <literal>multipart</literal> type) and Map (<literal>multipart/form-data</literal> only) objects."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Input with multipart/mixed"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you write a JAX-RS service, RESTEasy provides an interface to let you read any <literal>multipart</literal> MIME type: <literal>org.jboss.resteasy.plugins.providers.multipart.MultipartInput</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>MultipartInput</literal> is a simple interface that lets you access each part of the <literal>multipart</literal> message. Each part is represented by an <literal>InputPart</literal> interface, and is associated with a set of headers. You can unmarshal a part by calling one of the <literal>getBody()</literal> methods. The <literal>Type genericType</literal> parameter can be null, but the <literal>Class type</literal> parameter must be set. RESTEasy locates a <literal>MessageBodyReader</literal> based on the media type of the part, and the type information you pass in. The following piece of code unmarshalls XML parts into a JAXB annotated class called <literal>Customer</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you want to unmarshall a body part that is sensitive to generic type metadata, you can use the <literal>org.jboss.resteasy.util.GenericType</literal> class, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>GenericType</literal> is required here because it is the only way to obtain generic type information at runtime."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "java.util.List with multipart data"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If the body parts are uniform, you can provide a <literal>java.util.List</literal> as your input parameter and avoid unmarshalling each part manually. As you can see in the example code below, this must include the type being unmarshalled with the generic parameter of the List type declaration."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Input with multipart/form-data"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you write a JAX-RS service, RESTEasy provides an interface that lets you read the <literal>multipart/form-data</literal> MIME type. <literal>multipart/form-data</literal> is often found in web application HTML Form documents, and is generally used to upload files. The <literal>form-data</literal> format is like other <literal>multipart</literal> formats except that each inlined piece of content is associated with a name. The interface for <literal>form-data</literal> input is <literal>org.jboss.resteasy.plugins.providers.multipart.MultipartFormDataInput</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This works similarly to <literal>MultipartInput</literal>, as described earlier in this chapter."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "java.util.Map with multipart/form-data"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "With <literal>form-data</literal>, if the body parts are uniform, you can provide a <literal>java.util.Map</literal> as your input parameter and avoid unmarshalling each part manually. As you can see in the example code below, this must include the type being unmarshalled with the generic parameter of the List type declaration."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Input with multipart/related"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you write a JAX-RS service, RESTEasy provides an interface that lets you read the <literal>multipart/related</literal> MIME type. <literal>multipart/related</literal> indicates that message parts should be considered as parts of a whole, and not individually. You can use <literal>multipart/related</literal> to perform tasks like sending a web page complete with images in a single message."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Every <literal>multipart/related</literal> message has a <literal>root/start</literal> part that references other parts of the message. Parts are identified by their <literal>Content-ID</literal> headers. <literal>multipart/related</literal> is defined by RFC 2387. The interface for <literal>related</literal> input is <literal>org.jboss.resteasy.plugins.providers.multipart.MultipartRelatedInput</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "It works similarly to <literal>MultipartInput</literal>, as described earlier in this chapter."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Output with multipart"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides a simple API to output multipart data."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To output <literal>multipart</literal> data, create a <literal>MultipartOutput</literal> object and call <literal>addPart()</literal> methods. RESTEasy automatically finds a <literal>MessageBodyWriter</literal> to marshall your entity objects. As with <literal>MultipartInput</literal>, your marshalling may be sensitive to generic type metadata. In this case, use <literal>GenericType</literal>. The following example returns a <literal>multipart/mixed</literal> format to the calling client. The parts are JAXB-annotated <literal>Customer</literal> objects that will marshal into <literal>application/xml</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Multipart Output with java.util.List"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If the body parts are uniform, you can provide a <literal>java.util.Map</literal> as your input parameter and avoid unmarshalling each part manually or using a <literal>MultipartOutput</literal> object. As you can see in the example code below, this must include the type being unmarshalled with the generic parameter of the List type declaration. You must also annotate the method with <literal>@PartType</literal> to specify each part's media type. The following example returns a customer list to a client, where each customer is a JAXB object:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Output with multipart/form-data"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides a simple API to output multipart/form-data."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To output <literal>multipart/form-data</literal>, create a <literal>MultipartFormDataOutput</literal> object and call <literal>addFormData()</literal> methods. RESTEasy automatically locates a <literal>MessageBodyWriter</literal> to marshal your entity objects. As with <literal>MultipartInput</literal>, your marshalling may be sensitive to generic type metadata. In this case, use <literal>GenericType</literal>. The example below returns a <literal>multipart/form-data</literal> format to a calling client. The parts are JAXB-annotated <literal>Customer</literal> objects, which will be marshalled into <literal>application/xml</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Multipart FormData Output with java.util.Map"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If the body parts are uniform, you can provide a <literal>java.util.Map</literal> as your input parameter and avoid unmarshalling each part manually or using a <literal>MultipartFormDataOutput</literal> object. As you can see in the example code below, this must include the type being unmarshalled with the generic parameter of the List type declaration. You must also annotate the method with <literal>@PartType</literal> to specify each part's media type. This example returns a customer list to a client, where each customer is a JAXB object."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Output with multipart/related"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides a simple API to output <literal>multipart/related</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To output <literal>multipart/related</literal>, create a <literal>MultipartRelatedOutput</literal> object and call <literal>addPart()</literal> methods. The first added part is used as the root part of the <literal>multipart/related</literal> message. RESTEasy automatically locates a <literal>MessageBodyWriter</literal> to marshal your entity objects. As with <literal>MultipartInput</literal>, your marshalling may be sensitive to generic type metadata. In this case, use <literal>GenericType</literal>. The example below returns a <literal>multipart/related</literal> format to the calling client — a HTML file with two images."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "@MultipartForm and POJOs"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you are familiar with your <literal>multipart/form-data</literal> packets, you can map them to and from a POJO class with the <literal>@org.jboss.resteasy.annotations.providers.multipart.MultipartForm</literal> annotation and the <literal>@FormParam</literal> JAX-RS annotation. To do so, define a POJO with a default constructor (at least), and annotate its fields, properties, or both, with <literal>@FormParam</literal>s. These <literal>@FormParam</literal>s must also be annotated with <literal>@org.jboss.resteasy.annotations.providers.multipart.PartType</literal> to be output. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Once you have defined your POJO class, you can use it to represent <literal>multipart/form-data</literal>. The following code sends a <literal>CustomerProblemForm</literal> using the RESTEasy client framework:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Note that the <literal>@MultipartForm</literal> annotation tells RESTEasy that the object has <literal>@FormParam</literal>, and that it should be marshalled from that parameter. You can use the same object to receive <literal>multipart</literal> data. Here is an example of the server-side counterpart to the customer portal."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "XML-binary Optimized Packaging (Xop)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy supports packaging XOP (XML-binary Optimized Packaging) messages as <literal>multipart/related</literal>. This means that if you have a JAXB-annotated POJO that also holds some binary content, you can send it without needing to encode the binary in any other way. This results in faster transport while retaining the convenience of the POJO. (You can read more about XOP at the <ulink url=\"http://www.w3.org/TR/xop10/\">W3C web page</ulink>.)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Take the following JAXB-annotated POJO as an example. <literal>@XmlMimeType</literal> tells JAXB the MIME type of the binary content. (This is not required, but it is recommended.)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Here, <literal>myBinary</literal> and <literal>myDataHandler</literal> are processed as binary attachments, while the XOP object will be sent as XML. <literal>javax.activation.DataHandler</literal> is the most common supported type, so if you need a <literal>java.io.InputStream</literal> or a <literal>javax.activation.DataSource</literal>, you must use the <literal>DataHandler</literal>. <literal>java.awt.Image</literal> and <literal>javax.xml.transform.Source</literal> are also supported. We assume, in the previous example, that <literal>Customer</literal> is a JAXB-friendly POJO. The following is an example Java client to send the previous example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Consumes(MediaType.MULTIPART_RELATED)</literal> tells RESTEasy that we want to send <literal>multipart/related</literal> packages, a format that will hold our XOP message. <literal>@XopWithMultipartRelated</literal> tells RESTEasy that we want to create XOP messages. Now that we have a POJO and a client service capable of sending it, we need a server capable of reading it:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@Consumes(MediaType.MULTIPART_RELATED)</literal> tells RESTEasy that we want to read <literal>multipart/related</literal> packages. <literal>@XopWithMultipartRelated</literal> tells RESTEasy that we want to read XOP messages. We could also produce XOP return values by annotating them with <literal>@Produce</literal>."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Overview.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Overview.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Overview.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,49 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Overview"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "JSR-000311 JAX-RS is a Java Community Process (JCP) specification that provides a Java API for RESTful Web Services over the HTTP protocol. <application>RESTEasy</application> is a portable implementation of the JAX-RS specification that can run in any Servlet container, and integrates tightly with the JBoss Application Server (JBoss AS) to provide improved user experience in the JBoss AS environment. Where JAX-RS is a server-side only specification, RESTEasy brings JAX-RS functions to the client side through the RESTEasy JAX-RS Client Framework, allowing you to map outgoing HTTP requests to remote servers with JAX-RS and interface proxies."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy includes the JAX-RS implementation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy is portable to any Tomcat or Application Server that runs on Java Development Kit 5.0 or higher."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The RESTEasy server implementation can be used with Embedded JBoss for junit testing."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy integrates easily with Enterprise JavaBeans (EJB) and the Spring Framework."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy includes a client framework to simplify the process of writing HTTP clients, giving you the opportunity to define more than server bindings."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Preface.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Preface.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Preface.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,19 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Preface"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Client_Framework.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Client_Framework.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Client_Framework.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,124 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Client Framework"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The RESTEasy Client Framework is the alternative to the JAX-RS server-side specification. Instead of using JAX-RS annotations to map an incoming request to your RESTful Web Service method, the client framework creates a HTTP request to invoke on a remote RESTful Web Service, which can be any web resource that accepts HTTP requests."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has a client proxy framework that lets you invoke upon a remote HTTP resource by using JAX-RS annotations. You can write a Java interface and use JAX-RS annotations on methods and the interface. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The RESTEasy API is simple, and based on Apache HttpClient. You generate a proxy, and invoke methods on the proxy. The invoked method is then translated to a HTTP request (based on the method's annotations) and posted to the server. To set it up:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "See the <literal>ProxyFactory</literal> Java Documentation for more options. For instance, you may want to fine tune the <literal>HttpClient</literal> configuration."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@CookieParam</literal> creates a cookie header to send to the server. If you allocate your own <literal>javax.ws.rs.core.Cookie</literal> object and pass it as a parameter to a client proxy method, you do not require <literal>@CookieParam</literal> — the client framework understands that you are passing a cookie to the server, so no extra metadata is required."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The client framework can use the same providers available on the server. You must manually register them through the <literal>ResteasyProviderFactory</literal> singleton using the <literal>addMessageBodyReader()</literal> and <literal>addMessageBodyWriter()</literal> methods."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Abstract Responses"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you need to access the response code or the response headers of a client request, the <literal>Client-Proxy</literal> framework provides two options:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can return a <literal>javax.ws.rs.core.Response.Status</literal> enumeration from your method calls, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "After invoking on the server, the client proxy internally converts the HTTP response code into a <literal>Response.Status</literal> enumeration."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can retrieve all data associated with a request with the <literal>org.resteasy.spi.ClientResponse</literal> interface:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "All <literal>getEntity()</literal> methods are deferred until you invoke them. In other words, the response <literal>OutputStream</literal> is not read until you call one of these methods. The <literal>getEntity()</literal> method with no parameters can only be used if you have templated the <literal>ClientResponse</literal> within your method declaration. RESTEasy uses this generic type information to determine which media type the <literal>OutputStream</literal> is unmarshalled into. The <literal>getEntity()</literal> methods that take parameters let you specify the Object type the response should be marshalled into. This lets you dynamically extract the desired types at runtime. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Include the <literal>LibraryPojo</literal> in <literal>ClientResponse</literal>'s generic declaration so that the client proxy framework can unmarshal the HTTP response body."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Sharing an interface between client and server"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "It is usually possible to share an interface between the client and server. In the previous scenario, your JAX-RS services must implement an annotated interface, then reuse that same interface to create client proxies to invoke on the client side. However, this is limited when your JAX-RS methods return a Response object. This is problematic because, in a raw Response return type declaration, the client has no type information. There are two ways to work around this problem. The first is to use the <literal>@ClientResponseType</literal> annotation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This will not always work, because some <literal>MessageBodyReader</literal>s and <literal>MessageBodyWriter</literal>s need generic type information in order to match and service a request."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In this case, your client code can cast the returned Response object to a <literal>ClientResponse</literal> and use one of the typed <literal>getEntity()</literal> methods."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Client error handling"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you are using the Client Framework and your proxy methods return something other than a <literal>ClientResponse</literal>, the default client error handling comes into play. Any response code that is greater than <literal>399</literal> will automatically cause a <exceptionname>org.jboss.resteasy.client.ClientResponseFailure</exceptionname> exception:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Manual ClientRequest API"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has a manual API for invoking requests: <literal>org.jboss.resteasy.client.ClientRequest</literal> See the Java Documentation for a complete description of this class. A simple example is the following:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_EJB_Integration.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_EJB_Integration.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_EJB_Integration.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,49 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "EJB Integration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To integrate with Enterprise JavaBeans (EJB), you must first modify your EJB's published interfaces. Currently, RESTEasy only has simple portable integration with EJBs, so you must manually configure your RESTEasy <filename>WAR</filename>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To make an EJB a JAX-RS resource, annotate a stateless session bean's <literal>@Remote</literal> or <literal>@Local</literal> interface with JAX-RS annotations, as follows:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Next, in RESTEasy's <filename>web.xml</filename>, manually register the EJB with RESTEasy by using the <literal>resteasy.jndi.resources <context-param></literal>:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "At present, this is the only portable integration method for EJBs. Future versions of RESTEasy will be more tightly integrated with JBoss AS, so manual registrations and modifications to <filename>web.xml</filename> will be unnecessary."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you are using RESTEasy with an <filename>EAR</filename> and EJBs, the following structure is helpful:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Remove all libraries from <filename>WEB-INF/lib</filename> and place them in a common <filename>EAR</filename> library, or place the RESTEasy <filename>JAR</filename> dependencies in your application server's system classpath (that is, in JBoss AS, place them in <filename>server/default/lib</filename>)."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Embedded_Container.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Embedded_Container.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Embedded_Container.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,39 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Embedded Container"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy JAX-RS comes with an embeddable server that can be run from your classpath. It packages the TJWS (Tiny Java Web Server) embeddable Servlet container with JAX-RS."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "From the distribution, move the <filename>JAR</filename>s in <filename>resteasy-jaxrs.war/WEB-INF/lib</filename> into your classpath. You must register your JAX-RS beans programmatically using the embedded server's <literal>Registry</literal>. Here's an example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The server can either host non-encrypted or SSL-based resources, but not both. See the Java Documentation for <literal>TJWSEmbeddedJaxrsServer</literal> and its superclass <literal>TJWSServletServer</literal> for further information. The TJWS website is also very informative."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To use Spring, you will need the <literal>SpringBeanProcessor</literal>. Here is a pseudo-code example:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Reference_Guide.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Reference_Guide.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Reference_Guide.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,14 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Server-side_Mock_Framework.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Server-side_Mock_Framework.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Server-side_Mock_Framework.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,29 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Server-side Mock Framework"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy provides a mock framework so that you can invoke directly on your resource, without using the embeddable container."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "See the RESTEasy Java Documentation for a complete list of the methods associated with <literal>MockHttpRequest</literal> and <literal>MockHttpResponse</literal>."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Spring_Integration.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Spring_Integration.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/RESTEasy_Spring_Integration.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,79 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Spring Integration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy integrates with Spring 2.5. (We are interested in other forms of Spring integration, and encourage you to contribute.)"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Basic Integration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For Maven users, you must use the resteasy-spring artifact. Otherwise, the jar is available in the downloaded distribution."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy includes its own Spring <literal>ContextLoaderListener</literal>. This registers a RESTEasy-specific <literal>BeanPostProcessor</literal> that processes JAX-RS annotations when a bean is created by a <literal>BeanFactory</literal>. This means that RESTEasy automatically scans for <literal>@Provider</literal> and JAX-RS resource annotations on your bean class and registers them as JAX-RS resources."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You will need to alter your <filename>web.xml</filename> file:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>SpringContextLoaderListener</literal> must be declared after <literal>ResteasyBootstrap</literal> because it uses ServletContext attributes initialized by <literal>ResteasyBootstrap</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you do not use a Spring <literal>ContextLoaderListener</literal> to create your bean factories, you can manually register the RESTEasy <literal>BeanFactoryPostProcessor</literal> by allocating an instance of <literal>org.jboss.resteasy.plugins.spring.SpringBeanProcessor</literal>. You can obtain instances of a <literal>ResteasyProviderFactory</literal> and <literal>Registry</literal> from the <literal>ServletContext</literal> attribute, <literal>org.resteasy.spi.ResteasyProviderFactory and org.resteasy.spi.Registry</literal> (the fully-qualified name String of these classes). There is also <literal>org.jboss.resteasy.plugins.spring.SpringBeanProcessorServletAware</literal>, which automatically injects references to the <literal>Registry</literal> and <literal>ResteasyProviderFactory</literal> from the Servlet Context, assuming that you have used <literal>RestasyBootstrap</literal> to bootstrap RESTEasy."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy Spring integration supports both singletons and the <emphasis>prototype</emphasis> scope. It handles injecting <literal>@Context</literal> references. However, constructor injection is not supported, and when the <emphasis>prototype</emphasis> scope is used, RESTEasy injects any <literal>@*Param</literal>-annotated fields and setters before the request is dispatched."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can only use automatically proxied beans with RESTEasy Spring integration. Hand-coded proxying (that is, with <literal>ProxyFactoryBean</literal>) will have undesirable effects."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Spring MVC Integration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy can also integrate with the Spring <literal>DispatcherServlet</literal>. This is advantageous because the <filename>web.xml</filename> is simpler, you can dispatch to either Spring controllers or RESTEasy from under the same base URL, and you can use Spring <literal>ModelAndView</literal> objects as return arguments from <literal>@GET</literal> resource methods. To set this up, you must use the Spring <literal>DispatcherServlet</literal> in your <filename>web.xml</filename> file, and import the <filename>springmvc-resteasy.xml</filename> file into your base Spring beans xml file. Here is an example <filename>web.xml</filename> file:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Then, within your main Spring beans xml file, import the <filename>springmvc-resteasy.xml</filename> file."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Responses_using_coreResponse.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Responses_using_coreResponse.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Responses_using_coreResponse.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,24 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Responses using javax.ws.rs.core.Response"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can build custom responses by using the <literal>javax.ws.rs.core.Response</literal> and <literal>ResponseBuilder</literal> classes. To perform your own streaming, your entity response must be an implementation of <literal>javax.ws.rs.core.StreamingOutput</literal>. See the Java Documentation for further information."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Revision_History.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Revision_History.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Revision_History.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,24 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: member
+#, no-c-format
+msgid "JIRA corrections."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Securing_JAX-RS_and_RESTeasy.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Securing_JAX-RS_and_RESTeasy.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Securing_JAX-RS_and_RESTeasy.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,64 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Securing JAX-RS and RESTeasy"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Because RESTEasy is deployed as a Servlet, you must use standard <filename>web.xml</filename> constraints to enable authentication and authorization."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Unfortunately, <filename>web.xml</filename> constraints have limited compatibility with JAX-RS because of the limited URL pattern matching available in <filename>web.xml</filename>. URL patterns in <filename>web.xml</filename> support only simple wildcards, so JAX-RS resources like the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Cannot be mapped as a <filename>web.xml</filename> URL pattern such as:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To work around this problem, use the following security annotations on your JAX-RS methods. You must also set up some general security constraint elements in <filename>web.xml</filename> to enable authentication."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy JAX-RS supports the <literal>@RolesAllowed</literal>, <literal>@PermitAll</literal> and <literal>@DenyAll</literal> annotations on JAX-RS methods. By default, RESTEasy does not recognize these annotations. You must configure RESTEasy to enable role-based security by setting a context parameter, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Do not enable this if you are using EJBs. The EJB container will provide this function instead of RESTEasy."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "With this approach, you must declare all roles used within both the RESTEasy JAX-RS <filename>WAR</filename> file, and in your JAX-RS classes, and establish a security constraint that lets these roles access every URL handled by the JAX-RS runtime, assuming that RESTEasy authorizes correctly."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy authorisation checks if a method is annotated with <literal>@RolesAllowed</literal> and then performs <literal>HttpServletRequest.isUserInRole</literal>. If one of the the <literal>@RolesAllowed</literal> passes, the request is allowed. If not, a response is returned with a <literal>401</literal> (Unauthorized) response code."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The following is an example of a modified RESTEasy WAR file. Note that every role declared is allowed access to every URL controlled by the RESTEasy Servlet."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/StringConverter.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/StringConverter.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/StringConverter.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,29 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "String marshalling for String based @*Param"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@PathParam</literal>, <literal>@QueryParam</literal>, <literal>@MatrixParam</literal>, <literal>@FormParam</literal>, and <literal>@HeaderParam</literal> are represented as Strings in a raw HTTP request. These injected parameter types can be converted into objects if they have a <literal>valueOf(String)</literal> static method, or a constructor that takes one String parameter. If you have a class with <literal>valueOf()</literal>, or the String constructor is inappropriate for your HTTP request, you can plug in RESTEasy's proprietary <literal>@Provider</literal>:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This interface lets you use your own customized String marshalling. It is registered in <filename>web.xml</filename> under the <literal>resteasy.providers context-param</literal>. (See the Installation and Configuration chapter for details.) You can register it manually by calling the <literal>ResteasyProviderFactory.addStringConverter()</literal> method. A simple example of using the <literal>StringConverter</literal> follows:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Using_Path.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Using_Path.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Using_Path.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,104 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Using @Path and @GET, @POST, etc."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<programlisting> @Path(\"/library\") public class Library { @GET @Path(\"/books\") public String getBooks() {...} @GET @Path(\"/book/{isbn}\") public String getBook(@PathParam(\"isbn\") String id) { // search my database and get a string representation and return it } @PUT @Path(\"/book/{isbn}\") public void addBook(@PathParam(\"isbn\") String id, @QueryParam(\"name\") String name) {...} @DELETE @Path(\"/book/{id}\") public void removeBook(@PathParam(\"id\") String id {...} } </programlisting>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you have the RESTEasy Servlet configured and reachable at a root path of <literal>http://myhost.com/services</literal>, the requests would be handled by the <literal>Library</literal> class:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "GET http://myhost.com/services/library/books"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "GET http://myhost.com/services/library/book/333"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "PUT http://myhost.com/services/library/book/333"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "DELETE http://myhost.com/services/library/book/333"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@javax.ws.rs.Path</literal> annotation must exist on either the class or a resource method, or both. If it exists on both the class and method, the relative path to the resource method is a concatenation of the class and method."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@javax.ws.rs package</literal> contains annotations for each HTTP method. <literal>@GET</literal>, <literal>@POST</literal>, <literal>@PUT</literal>, <literal>@DELETE</literal>, and <literal>@HEAD</literal>. Place these annotations on public methods that you want to map to the annotation's HTTP method. If a <literal>@Path</literal> annotation exists on the class, you do not need to annotate the method you wish to map with <literal>@Path</literal>. Multiple HTTP methods can be used, as long as they can be distinguished from other methods."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When a method is annotated with <literal>@Path</literal> without a HTTP method being applied, the annotated method is referred to as a <literal>JAXRSResourceLocator</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "@Path and regular expression mappings"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@Path</literal> annotation is not limited to simple path expressions. You can also insert regular expressions into the value of <literal>@Path</literal>. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The following GETs will route to the <literal>getResource()</literal> method:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The format of the expression is:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Here, <literal>regular-expression</literal> is optional. Where this is not provided, the expression defaults to a wildcard matching of one particular segment, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "will match these:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "but will not match:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/Yaml.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/Yaml.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/Yaml.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,64 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "YAML Provider"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Since Beta 6, RESTEasy includes built-in support for YAML with the JYAML library. To enable YAML support, add the <filename>jyaml-1.3.jar</filename> to RESTEasy's classpath."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The JYAML <filename>JAR</filename> can be downloaded from <ulink url=\"https://sourceforge.net/project/showfiles.php?group_id=153924\">SourceForge</ulink>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you use Maven, the JYAML <filename>JAR</filename> is available through the main repositories, and included with the following dependency:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When starting up RESTEasy, watch the logs for a line stating that the <literal>YamlProvider</literal> has been added — this indicates that RESTEasy has located the JYAML <filename>JAR</filename>:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The YAML provider recognises three MIME types:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>text/x-yaml</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>text/yaml</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>application/x-yaml</literal>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can use YAML in a resource method like so:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Context.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Context.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Context.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,24 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@Context"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@Context</literal> annotation allows you to inject instances of <literal>javax.ws.rs.core.HttpHeaders</literal>, <literal>javax.ws.rs.core.UriInfo</literal>, <literal>javax.ws.rs.core.Request</literal>, <literal>javax.servlet.HttpServletRequest</literal>, <literal>javax.servlet.HttpServletResponse</literal>, <literal>javax.servlet.ServletConfig</literal>, <literal>javax.servlet.ServletContext</literal>, and <literal>javax.ws.rs.core.SecurityContext</literal> objects."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_CookieParam.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_CookieParam.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_CookieParam.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,29 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@CookieParam"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@CookieParam</literal> annotation allows you to inject the value of a cookie, or an object representation of an HTTP request cookie, into your method invocation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As with <literal>@PathParam</literal>, the type of parameter can be a primitive, a String, or a class with a String constructor or static <literal>valueOf()</literal> method. You can also get an object representation of the cookie via the <literal>javax.ws.rs.core.Cookie</literal> class."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_DefaultValue.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_DefaultValue.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_DefaultValue.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,24 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@DefaultValue"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@DefaultValue</literal> is a parameter annotation that can be combined with any other <literal>@<replaceable>*</replaceable>Param</literal> annotations to define a default value where the HTTP request item does not exist."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Encoded_and_encoding.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Encoded_and_encoding.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Encoded_and_encoding.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,59 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@Encoded and encoding"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "JAX-RS allows you to get encoded or decoded <literal>@<replaceable>*</replaceable>Param</literal>s and specify path definitions and parameter names using encoded or decoded strings."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@javax.ws.rs.Encoded</literal> annotation can be used on a class, method, or parameter. By default, injected <literal>@PathParam</literal> and <literal>@QueryParam</literal> are decoded. Adding the <literal>@Encoded</literal> annotation means that the value of these parameters will be provided in encoded form."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In the previous example, the value of the <literal>@PathParam</literal> injected into the <literal>param</literal> of the <literal>get()</literal> method will be URL encoded. Adding the <literal>@Encoded</literal> annotation as a parameter annotation triggers this effect."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can also use the <literal>@Encoded</literal> annotation on the entire method and any combination of <literal>@QueryParam</literal> or <literal>@PathParam</literal>'s values will be encoded."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In this example, the values of the <literal>foo</literal> query parameter and the <literal>param</literal> path parameter will be injected as encoded values."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can also set the default to be encoded for the entire class."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@Path</literal> annotation has an attribute called <emphasis>encode</emphasis>. This controls whether the literal part of the value supplied (that is, the characters that are not part of a template variable) are URL-encoded. If <literal>true</literal>, any characters in the URI template that are not valid will be automatically encoded. If <literal>false</literal>, then all characters must be valid URI characters. By default, the <literal>encode</literal> attribute is set to <literal>true</literal>. (You can also encode the characters by hand.)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As with <literal>@Path.encode()</literal>, this controls whether the specified query parameter name should be encoded by the container before it tries to find the query parameter in the request."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Form.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Form.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_Form.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,29 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@Form"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This is a RESTEasy-specific annotation that allows you to reuse any <literal>@<replaceable>*</replaceable>Param</literal> annotation within an injected class. RESTEasy instantiates the class and injects values into any annotated <literal>@<replaceable>*</replaceable>Param</literal> or <literal>@Context</literal> property. This is useful if you have many parameters on your method and you want to condense them into a value object."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When someone posts to <literal>/myservice</literal>, RESTEasy instantiates an instance of <literal>MyForm</literal> and injects the form parameter <literal>stuff</literal> into the <literal>stuff</literal> field, the header <literal>myheader</literal> into the <literal>header</literal> field, and call the <literal>setFoo</literal> method with the <literal>@PathParam</literal> variable of <literal>foo</literal>."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_FormParam.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_FormParam.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_FormParam.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,34 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@FormParam"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When the input request body is of the type <literal>application/x-www-form-urlencoded</literal> (that is, an HTML form), you can inject individual form parameters from the request body into method parameter values."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you post using this form, the service would look as follows:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You cannot combine <literal>@FormParam</literal> with the default <literal>application/x-www-form-urlencoded</literal> that unmarshalls to a <literal>MultivaluedMap<String, String></literal> That is, the following would be illegal:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_HeaderParam.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_HeaderParam.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_HeaderParam.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,29 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@HeaderParam"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <literal>@HeaderParam</literal> annotation allows you to map a request HTTP header onto your method invocation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As with <literal>@PathParam</literal>, the type of parameter can be a primitive, a String, or a class with a String constructor or static <literal>valueOf()</literal> method. For example, <literal>MediaType</literal> has a <literal>valueOf()</literal> method, so you could do the following:"
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_MatrixParam.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_MatrixParam.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_MatrixParam.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,34 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@MatrixParam"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Matrix parameters are an arbitrary set of name-value pairs embedded in a URI path segment. An example of a matrix parameter is:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Matrix parameters represent resources that can be addressed by their attributes as well as their raw ID. The <literal>@MatrixParam</literal> annotation lets you injext URI matrix parameters into your method invocation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "One limitation with <literal>@MatrixParam</literal> is that the current version of the specification does not resolve. If, for example, the same <literal>MatrixParam</literal> exists simultaneously in different path segments, at present we recommend using <literal>PathParam</literal> combined with <literal>PathSegment</literal>."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_PathParam.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_PathParam.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_PathParam.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,99 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@PathParam"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<literal>@PathParam</literal> is a parameter annotation which allows you to map variable URI path fragments into your method call."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This lets you embed variable identification in the URIs of your resources. The previous example shows an <literal>isbn</literal> URI parameter passing information about a particular book we want to access. You can inject into any primitive parameter type, a String, any Java object that takes a String parameter, or a static <literal>valueOf</literal> method that takes a String parameter. For example, if we wanted <literal>isbn</literal> to be a real object, we could write:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Or instead of a public String constructor, we could have a <literal>valueOf</literal> method:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Advanced @PathParam and Regular Expressions"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "There are several more complicated uses of <literal>@PathParam</literal>s."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You are allowed to specify one or more <literal>@PathParam</literal>s embedded in one URI segment. For example:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<programlisting> 1. @Path(\"/aaa{param}bbb\") 2. @Path(\"/{name}-{zip}\") 3. @Path(\"/foo{name}-{zip}bar\") </programlisting>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "So, a URI of the form \"/aaa111bbb\" would match the first specified parameter. \"/bill-02115\" would match the second, and \"foobill-02115bar\" would match the third."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In <xref linkend=\"_Path_and_regular_expression_mappings\" />, we mentioned that regular expressions can be used within <literal>@Path</literal> values, like so:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "With the <literal>@Path</literal> defined here, the request <literal>GET /aaabb/some/stuff</literal> would have a <literal>\"param\"</literal> value of <literal>bb</literal>, and a <literal>\"many\"</literal> value of <literal>some</literal>. The request <literal>GET /aaab/a/lot/of/stuff</literal> would have a <literal>\"param\"</literal> value of <literal>b</literal>, and a <literal>\"many\"</literal> value of <literal>a/lot/of</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "@PathParam and PathSegment"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The specification has a very simple abstraction for examining a fragment of the URI path being invoked on <literal>javax.ws.rs.core.PathSegment</literal>:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy can inject a <literal>PathSegment</literal> instead of a value with your <literal>@PathParam</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This is particularly useful when you have multiple <literal>@PathParam</literal>s that use <emphasis>matrix parameters</emphasis>. Matrix parameters are an arbitrary set of name-value pairs embedded in a URI path segment. The <literal>PathSegment</literal> object fives you access to these parameters. See <xref linkend=\"_MatrixParam\" /> for further information."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "An example of a matrix parameter:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A matrix parameter represents a resource that can be addressed by its attributes as well as its raw ID."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/_QueryParam.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/_QueryParam.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/_QueryParam.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,29 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "@QueryParam"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The @QueryParam annotation allows you to map a URI query string parameter or URL form-encoded parameter onto your method invocation."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Since RESTEasy is built on a Servlet, it cannot distinguish between URL query strings and URL form-encoded parameters. As with <literal>@PathParam</literal>, the type of parameter can be a primitive, a String, or a class with a String constructor or static <literal>valueOf()</literal> method."
+msgstr ""
+
Added: projects/docs/enterprise/5.0/RESTEasy/ja-JP/gzip.po
===================================================================
--- projects/docs/enterprise/5.0/RESTEasy/ja-JP/gzip.po (rev 0)
+++ projects/docs/enterprise/5.0/RESTEasy/ja-JP/gzip.po 2010-01-07 06:38:13 UTC (rev 99096)
@@ -0,0 +1,34 @@
+#
+# AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2010-01-07T06:35:58\n"
+"PO-Revision-Date: 2010-01-07T06:35:58\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "GZIP Compression/Decompression"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy has automatic GZIP decompression support. If the client framework or a JAX-RS service receives a message body with a <literal>Content-Encoding</literal> of <literal>gzip</literal>, the message will be automatically decompressed. The client framework also sets the <literal>Accept-Encoding</literal> header to <literal>gzip, deflate</literal> automatically."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "RESTEasy also supports automatic compression. If a request or response with a <literal>Content-Encoding</literal> header of <literal>gzip</literal> is sent or received, RESTEasy performs the compression. You can use the <literal>@org.jboss.resteasy.annotation.GZIP</literal> annotation if you do not want to set each <literal>Content-Encoding</literal> manually."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Here, the <literal>order</literal> message body is tagged for GZIP compression. You can use the same annotation to tag server responses:"
+msgstr ""
+
More information about the jboss-cvs-commits
mailing list