@Target({TYPE})
@Retention(RUNTIME)
public @interface XmlNamedObjectGraphs{
     XmlNamedObjectGraph[] value();
}

@Target({TYPE})
@Retention(RUNTIME)
public @interface XmlNamedObjectGraph {
    /**
     * The name of this object graph. Defaults to the name of the class
     */
    String name();
 
    /**
     * The list of properties to be marshalled/unmarshalled for this graph.
     */
    XmlNamedAttributeNode[] attributeNodes();
 
    /**
     * Optional: a list of named subgraphs that are referenced 
     * from the property entries.
     */
    XmlNamedSubGraph[] subGraphs();
 
    /**
     * Optional: a list of named subgraphs for any subclasses
     * of this class.
     */
    XmlNamedSubGraph[] subclassGraphs();
}

@Target({TYPE})
@Retention(RUNTIME)
public @interface NamedAttributeNode
    /**
     * required: the name of the property
     */
    String value();
 
    /** optional: if this property referenced another JAXB Object, 
     *  specify the name of the object graph to use for that nested object. 
     */ By default, the full object will be read.
    String subgraph();
}

@Target({TYPE})
@Retention(RUNTIME)
public @interface XmlNamedSubGraph {
   /**
    * required: the name of the subgraph
    */
   String name();
 
   /**
    * optional: only required for inheritance or with ChoiceMappings 
    * to specify which of the possible targets this subgraph is to be
    * applied to. 
   Class type();
 
   /**
    * The list of properties to include in this graph
    */
   XmlNamedAttributeNode[]  properties();
}

@XmlNamedObjectGraph(name="simple", 
   properties={@XmlNamedAttributeNode(value="firstName"), 
               @XmlNamedAttributeNode(value="address", subgraph="simple")
   }
)
public class Employee {
   public String firstName;
   public String lastName;
   public Address address;
}
@XmlNamedObjectGraph(name="simple", 
   properties={
      @XmlNamedAttributeNode(value="firstName"), 
      @XmlNamedAttributeNode(value="address", subgraph="basic")
   }, 
   subgraphs={
      @XmlNamedSubGraph(name="basic", 
         properties={
            @XmlNamedAttributeNode("city")
          }
   }
)
public class Customer {
   public String firstName;
   public String lastName;
   public Address address;
}
 
@XmlNamedObjectGraphs(name="simple", 
   properties = {
      @XmlNamedAttributeNode("street"), 
      @XmlNamedAttributeNode("city"), 
      @XmlNamedAttributeNode("country")
    }
)
public class Address {
   public String street;
   public String city;
   public String country;
   public String zipCode;
}

public interface ObjectGraph {
    /**
     * Returns the name of the static EntityGraph.  Will return null if the
     * EntityGraph is not a named EntityGraph.
     */
    public String getName();
 
    /*
     * Add an AttributeNode attribute to the entity graph.
     *
     * @throws IllegalArgumentException if the attribute is not an attribute of
     * this entity.
     * @throws IllegalStateException if this EntityGraph has been statically
     * defined
     */
    public void addAttributeNodes(String ... attributeName);
 
 
    /*
     * Used to add a node of the graph that corresponds to a managed type. This
     * allows for construction of multi-node Entity graphs that include related
     * managed types.
     *
     * @throws IllegalArgumentException if the attribute is not an attribute of
     * this entity.
     * @throws IllegalArgumentException if the attribute's target type is not a
     * managed type
     *
     * @throws IllegalStateException if this EntityGraph has been statically
     * defined
     */
    public Subgraph addSubgraph(String attribute);
 
    /**
     * Used to add a node of the graph that corresponds to a managed type with
     * inheritance.  This allows for multiple subclass sub-graphs to be defined
     * for this node of the entity graph.  Subclass sub-graphs will include the
     * specified attributes of superclass sub-graphs
     *
     * @throws IllegalArgumentException if the attribute is not an attribute of
     * this managed type.
     * @throws IllegalArgumentException
     *             if the attribute's target type is not a managed type
     * @throws IllegalStateException
     *             if this EntityGraph has been statically defined
     */
    public Subgraph addSubgraph(String attribute, Class type);
 
    /*
     * returns the attributes of this entity that are included in the entity
     * graph
     */
    public List<AttributeNode> getAttributeNodes();
 
}

public interface Subgraph extends AttributeNode {
 
    /**
     * Add an AttributeNode attribute to the entity graph.
     *
     * @throws IllegalArgumentException if the attribute is not an attribute of
     * this managed type.
     * @throws IllegalStateException
     *             if this EntityGraph has been statically defined
     */
    public void  addAttributeNodes(String ... attributeName);
 
    /**
     * Used to add a node of the graph that corresponds to a managed type. This
     * allows for construction of multi-node Entity graphs that include related
     * managed types.
     *
     * @throws IllegalArgumentException if the attribute is not an attribute of
     * this managed type.
     * @throws IllegalArgumentException
     *             if the attribute's target type is not a managed type
     * @throws IllegalStateException
     *             if this EntityGraph has been statically defined
     */
    public Subgraph addSubgraph(String attribute);
 
    /**
     * Used to add a node of the graph that corresponds to a managed type with
     * inheritance.  This allows for multiple subclass sub-graphs to be defined
     * for this node of the entity graph. Subclass sub-graphs will include the
     * specified attributes of superclass sub-graphs
     *
     * @throws IllegalArgumentException if the attribute is not an attribute of
     * this managed type.
     * @throws IllegalArgumentException
     *             if the attribute's target type is not a managed type
     * @throws IllegalStateException
     *             if this EntityGraph has been statically defined
     */
    public Subgraph addSubgraph(String attribute, Class type);
 
 
 
    /**
     * returns the attributes of this managed type that are included in the
     * sub-graph
     */
    public List<AttributeNode> getAttributeNodes();
 
    /**
     * returns the attribute that references this sub-graph.
     /
    public <T> Attribute<T,X> getReferencingAttribute();
 
    /**
     * returns the type of this sub-graph if it was used to extend a superclass
     * sub-graph definition.
     */
    public Class getClassType();
}

/**
 * Represents an AttributeNode of an entity graph.
 */
public interface AttributeNode {
 
    /*
     * returns the name of the referencing attribute.
     */
    public String getAttributeName();
}

ObjectGraph graph = JAXBContext.createObjectGraph(Customer.class);
graph.addAttributeNodes("lastName");
graph.addAttributeNodes("age");
SubGraph<Address> subGraph = graph.addSubGraph("address", Address.class);
subGraph.addAttributeNodes("country");
 
jaxbMarshaller.setProperty(MarshallerProperties.MARSHAL_OBJECT_GRAPH, graph);

@XmlNamedObjectGraph(name="simple", properties={@XmlNamedAttributeNode("province")})
public class CanadianAddress extends Address {
  public String province;
}
@XmlNamedObjectGraph(name="simple", properties={@XmlNamedAttributeNode("state")})
public class AmericanAddress extends Address {
  public String state;
}

JAXBContext ctx = JAXBContext.newInstance("foo.bar");
Marshaller m = ctx.createMarshaller();
m.setProperty(MarshalProperties.OBJECT_GRAPH, "simple");
m.marshal(myCustomer, System.out);

JAXBContext ctx = JAXBContext.newInstance("foo.bar");
ctx.setProperty(MarshalProperties.OBJECT_GRAPH, "simple");
Marshaller m = ctx.createMarshaller();
m.marshal(myCustomer, System.out);