Tell me more ×  Alright, I've been put in charge of both the
server and client (used internally) part of this RESTful
architecture. (using restlet).  We've got a resource that
exposes the Post operation. Here's a simplified version:  public
class UserResource {      public Representation
create(UserRegistration registration) {         return new
XstreamRepresentation(new
RegistrationResponse(registration.getUniqueCode()););  For a few
months, we've been the only ones using these services, so domain
objects were shared across client and server sides... and it's
been working just fine.  Now that we have to document these
resources and let other clients use them some "issues" have been
arising that made me think this API might be a little too
complicated.  This Post service, for example. The internal
method accepts complex type UserRegistration  public class
UserRegistration implements Serializable {      private Profile
profile;     private Boolean someBooleanProperty;      public
UserRegistration(Profile profi