< prev index next >

src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/package-info.java

Print this page

        

*** 1,7 **** /* ! * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this --- 1,7 ---- /* ! * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this
*** 26,45 **** /** * <h1>The JAXB 2.0 runtime</h1>. * * <h1>Overview</h1> * <p> ! * This module provides code that implements {@link JAXBContext}. * Roughly speaking the runtime works like this: * * <ol> * <li>There's a set of classes and interfaces that model JAXB-bound types. * You can think of this as a reflection library for JAXB. * <li>There's a set of classes that constitute the unmarshaller and marshaller. * Each class represents a small portion, and they are composed to perform * the operations. ! * <li>{@link JAXBContextImpl} builds itself by reading the model and * composing unmarshallers and marshallers. * </ol> * * <h1>Interesting Pieces inside Runtime</h1> * <p> --- 26,45 ---- /** * <h1>The JAXB 2.0 runtime</h1>. * * <h1>Overview</h1> * <p> ! * This module provides code that implements {@link javax.xml.bind.JAXBContext}. * Roughly speaking the runtime works like this: * * <ol> * <li>There's a set of classes and interfaces that model JAXB-bound types. * You can think of this as a reflection library for JAXB. * <li>There's a set of classes that constitute the unmarshaller and marshaller. * Each class represents a small portion, and they are composed to perform * the operations. ! * <li>{@link com.sun.xml.internal.bind.v2.runtime.JAXBContextImpl} builds itself by reading the model and * composing unmarshallers and marshallers. * </ol> * * <h1>Interesting Pieces inside Runtime</h1> * <p>
*** 66,76 **** * <p> * The following picture illustrates the relationship among major * packages of the binding model. * * <div> ! * <img src="doc-files/packages.png"/> * </div> * * <p> * The core model contracts are all interfaces, and they are parameterized * so that they can be used --- 66,76 ---- * <p> * The following picture illustrates the relationship among major * packages of the binding model. * * <div> ! * <img src="doc-files/packages.png" alt=""> * </div> * * <p> * The core model contracts are all interfaces, and they are parameterized * so that they can be used
*** 107,133 **** * <p> * The binding model design roughly looks like the following. * For more details, see the javadoc of each component. * * <div> ! * <img src="doc-files/j2s_architecture.gif"/> * </div> * * <b><i>TODO: link to classes from above pictures</i></b> * * ! * <h3>Evolution Rules</h3> * None of the class in this package or below should be directly * referenced by the generated code. Hence they can be changed freely * from versions to versions. * * * * * <h1>Performance Characteristics</h1> * <p> ! * Model construction happens inside {@link JAXBContext#newInstance(Class[])}. * It's desirable for this step to be fast and consume less memory, * but it's not too performance sensitive. * * <p> * Code that implements the unmarshaller and the marshaller OTOH --- 107,133 ---- * <p> * The binding model design roughly looks like the following. * For more details, see the javadoc of each component. * * <div> ! * <img src="doc-files/j2s_architecture.gif" alt=""> * </div> * * <b><i>TODO: link to classes from above pictures</i></b> * * ! * <h2>Evolution Rules</h2> * None of the class in this package or below should be directly * referenced by the generated code. Hence they can be changed freely * from versions to versions. * * * * * <h1>Performance Characteristics</h1> * <p> ! * Model construction happens inside {@link javax.xml.bind.JAXBContext#newInstance(Class[])}. * It's desirable for this step to be fast and consume less memory, * but it's not too performance sensitive. * * <p> * Code that implements the unmarshaller and the marshaller OTOH
*** 137,150 **** * * * * <h1>Bootstrap Sequence</h1> * <p> ! * The following picture illustrates how the {@link JAXBContext#newInstance(Class[])} method * triggers activities. * ! * {@SequenceDiagram boxwid=1.2; pobject(U,"user"); object(A,"JAXB API"); object(CF,"ContextFactory"); --- 137,150 ---- * * * * <h1>Bootstrap Sequence</h1> * <p> ! * The following picture illustrates how the {@link javax.xml.bind.JAXBContext#newInstance(Class[])} method * triggers activities. * ! * {@code SequenceDiagram boxwid=1.2; pobject(U,"user"); object(A,"JAXB API"); object(CF,"ContextFactory");
*** 175,182 **** complete(JC); complete(CF); complete(A); * } * - * @ArchitectureDocument */ package com.sun.xml.internal.bind.v2; --- 175,181 ----
< prev index next >