{"type":"doc","content":[{"type":"paragraph","content":[{"text":"A common way to use the REST protocol is to transmit a Java Bean’s content in the message body. For this option to work, we need to have a method that will allow us to marshal the Java object to and from a suitable data format. ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"34ef4dc8184c238044480821fe443b5e"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"2c2ab1fa-13c6-49bb-bf90-c6ee6ad9e765"}},{"type":"paragraph","content":[{"text":"These data formats (suitable for encoding Java objects), are supported by the REST DSL:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JSON","type":"text"}]},{"type":"paragraph","content":[{"text":"JSON (JavaScript object notation) is a lightweight data format that can easily be mapped to and from Java objects. The JSON syntax is compact, lightly typed, and easy for humans to read and write. For all of these reasons, JSON has become popular as a message format for REST services.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, lets assume the following JSON code could represent a ","type":"text"},{"text":"User","type":"text","marks":[{"type":"code"}]},{"text":" bean with two property fields, ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"id\" : 1234,\n \"name\" : \"Jane Doe\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JAXB","type":"text"}]},{"type":"paragraph","content":[{"text":"JAXB (Java Architecture for XML Binding) is an XML-based data format we can use for mapping to and from Java objects. Thus, to marshal the XML to a Java object, you need to annotate the Java class that you want to use.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, lets assume the following JAXB code could represent a ","type":"text"},{"text":"User","type":"text","marks":[{"type":"code"}]},{"text":" bean with two property fields, ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n 1234\n Jane Doe\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Integration of JSON and JAXB with REST DSL","type":"text"}]},{"type":"paragraph","content":[{"text":"We could write the necessary code to convert the message body to and from a Java object, but the REST DSL can perform this conversion automatically. The integration of JSON and JAXB with the REST DSL offers these advantages:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Marshalling to and from Java objects is performed automatically (with the correct configuration).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REST DSL will automatically detect the data format (either JSON or JAXB) and perform the correct conversion.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REST DSL has an ","type":"text"},{"text":"abstraction layer","type":"text","marks":[{"type":"em"}]},{"text":" so that our code is not specific to a particular JSON or JAXB implementation. This allows us to switch the implementation with minimum impact to your application.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Supported Data Formats","type":"text"}]},{"type":"paragraph","content":[{"text":"Apache Camel provides a number of different implementations of the JSON and JAXB data formats. The following data formats are currently supported by the REST DSL:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JSON","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Jackson data format (","type":"text"},{"text":"camel-jackson","type":"text","marks":[{"type":"code"}]},{"text":") ","type":"text"},{"text":"(this is the default)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GSon data format (","type":"text"},{"text":"camel-gson","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"XStream data format (","type":"text"},{"text":"camel-xstream","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JAXB","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JAXB data format (","type":"text"},{"text":"camel-jaxb","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Enable Object Marshalling","type":"text"}]},{"type":"paragraph","content":[{"text":"To enable object marshalling in the REST DSL, we must be cognizant of these points:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable binding mode, by setting the ","type":"text"},{"text":"bindingMode","type":"text","marks":[{"type":"code"}]},{"text":" option.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Identify the Java type to be converted to (or From), on each of our incoming message using the ","type":"text"},{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" option (","type":"text"},{"text":"required","type":"text","marks":[{"type":"em"}]},{"text":"), and also on any outgoing message using the ","type":"text"},{"text":"outType","type":"text","marks":[{"type":"code"}]},{"text":" option (","type":"text"},{"text":"optional","type":"text","marks":[{"type":"em"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In order to convert your Java object to/from the JAXB data format, we must annotate the class with the correct JAXB annotations.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We will need to specify the underlying data format implementation(s), using the ","type":"text"},{"text":"jsonDataFormat","type":"text","marks":[{"type":"code"}]},{"text":" option and/or the ","type":"text"},{"text":"xmlDataFormat","type":"text","marks":[{"type":"code"}]},{"text":" option (use the ","type":"text"},{"text":"restConfiguration","type":"text","marks":[{"type":"code"}]},{"text":" builder).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When our route generates a return value in JAXB format, it is anticipated that we will set the ","type":"text"},{"text":"Out","type":"text","marks":[{"type":"strong"}]},{"text":" message of the exchange body to be an instance of a class with JAXB annotations (ie. JAXB element). ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We will need to add the required dependencies to your POM file. For example, using the Maven build system with the Jackson data format, we would add the following dependency:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\n\n ...\n \n ...\n org.apache.camel camel-jackson \n ...\n \n","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"REST DSL Route with JSON Binding","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"\n\n ...\n \n \n\n \n\n \n \n \n\n \n \n User rest service\n\n \n \n Find user by id\n \n \n\n \n \n Updates or create a user\n \n \n\n \n \n Find all users\n \n \n\n \n","type":"text"}]}],"version":1}

Browser not supported