Revision: 10488
Author: [email protected]
Date: Tue Aug 2 17:49:09 2011
Log: Created wiki page through web user interface.
http://code.google.com/p/google-web-toolkit/source/detail?r=10488
Added:
/wiki/RequestFactoryInterfaceValidation.wiki
=======================================
--- /dev/null
+++ /wiki/RequestFactoryInterfaceValidation.wiki Tue Aug 2 17:49:09 2011
@@ -0,0 +1,25 @@
+#summary Provides late validation of RequestFactory interfaces
+
+RequestFactory interfaces must be validated before they can be used by the
RequestFactory server code or JVM-based clients. This document explains
the mechanisms for validating those interfaces.
+
+<wiki:toc />
+
+= Overview =
+
+The RequestFactory annotation processor will validate the RequestFactory
interface declarations and ensure that the mapping of proxy properties and
context methods to their domain types is valid. The manner in which the
errors are reported depends on the method by which the annotation processor
is invoked.
+
+In addition to validating the interfaces, the annotation processor also
generates addition Java types which embed pre-computed metadata that is
required by the RequestFactory server components. Users of
`RequestFactorySource` must also run the annotation processor in order to
provide the client code with obfuscated type token mappings. In the
client-only case, the server domain types are not required.
+
+It is necessary for both the shared RequestFactory interfaces and their
server domain counterparts to be available on the classpath. In order to
accomodate different build processes, the va
+
+= Annotation Processor =
+
+== javac builds==
+
+Users using javac 1.6 or later to compile their server projects need only
to include the `requestfactory-client.jar` on the build classpath. The
compiler will automatically load the annotation processor from the JAR file.
+
+== IDE configuration ==
+
+* TODO * add screenshots for how to configure Eclipse.
+
+= !ValidationTool =
--
http://groups.google.com/group/Google-Web-Toolkit-Contributors
