src/share/jaxws_classes/com/sun/tools/internal/xjc/model/nav/NType.java

Tue, 09 Apr 2013 14:51:13 +0100

author
alanb
date
Tue, 09 Apr 2013 14:51:13 +0100
changeset 368
0989ad8c0860
parent 0
373ffda63c9a
permissions
-rw-r--r--

8010393: Update JAX-WS RI to 2.2.9-b12941
Reviewed-by: alanb, erikj
Contributed-by: miroslav.kos@oracle.com, martin.grebac@oracle.com

aoqi@0 1 /*
aoqi@0 2 * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
aoqi@0 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
aoqi@0 4 *
aoqi@0 5 * This code is free software; you can redistribute it and/or modify it
aoqi@0 6 * under the terms of the GNU General Public License version 2 only, as
aoqi@0 7 * published by the Free Software Foundation. Oracle designates this
aoqi@0 8 * particular file as subject to the "Classpath" exception as provided
aoqi@0 9 * by Oracle in the LICENSE file that accompanied this code.
aoqi@0 10 *
aoqi@0 11 * This code is distributed in the hope that it will be useful, but WITHOUT
aoqi@0 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
aoqi@0 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
aoqi@0 14 * version 2 for more details (a copy is included in the LICENSE file that
aoqi@0 15 * accompanied this code).
aoqi@0 16 *
aoqi@0 17 * You should have received a copy of the GNU General Public License version
aoqi@0 18 * 2 along with this work; if not, write to the Free Software Foundation,
aoqi@0 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
aoqi@0 20 *
aoqi@0 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
aoqi@0 22 * or visit www.oracle.com if you need additional information or have any
aoqi@0 23 * questions.
aoqi@0 24 */
aoqi@0 25
aoqi@0 26 package com.sun.tools.internal.xjc.model.nav;
aoqi@0 27
aoqi@0 28 import com.sun.codemodel.internal.JType;
aoqi@0 29 import com.sun.tools.internal.xjc.outline.Aspect;
aoqi@0 30 import com.sun.tools.internal.xjc.outline.Outline;
aoqi@0 31
aoqi@0 32 /**
aoqi@0 33 * A type.
aoqi@0 34 *
aoqi@0 35 * See the package documentaion for details.
aoqi@0 36 *
aoqi@0 37 * @author Kohsuke Kawaguchi
aoqi@0 38 */
aoqi@0 39 public interface NType {
aoqi@0 40 /**
aoqi@0 41 * Returns the representation of this type in code model.
aoqi@0 42 * <p>
aoqi@0 43 * This operation requires the whole model to be built,
aoqi@0 44 * and hence it takes {@link Outline}.
aoqi@0 45 * <p>
aoqi@0 46 * Under some code generation strategy, some bean classes
aoqi@0 47 * are considered implementation specific (such as impl.FooImpl class)
aoqi@0 48 * These classes always have accompanying "exposed" type (such as
aoqi@0 49 * the Foo interface).
aoqi@0 50 * <p>
aoqi@0 51 * For such Jekyll and Hyde type, the aspect parameter determines
aoqi@0 52 * which personality is returned.
aoqi@0 53 *
aoqi@0 54 * @param aspect
aoqi@0 55 * If {@link Aspect#IMPLEMENTATION}, this method returns the
aoqi@0 56 * implementation specific class that this type represents.
aoqi@0 57 * If {@link Aspect#EXPOSED}, this method returns the
aoqi@0 58 * publicly exposed type that this type represents.
aoqi@0 59 *
aoqi@0 60 * For ordinary classes, the aspect parameter is meaningless.
aoqi@0 61 *
aoqi@0 62 */
aoqi@0 63 JType toType(Outline o, Aspect aspect);
aoqi@0 64
aoqi@0 65 /**
aoqi@0 66 * Returns true iff this type represents a class that has a unboxed form.
aoqi@0 67 *
aoqi@0 68 * For example, for {@link String} this is false, but for {@link Integer}
aoqi@0 69 * this is true.
aoqi@0 70 */
aoqi@0 71 boolean isBoxedType();
aoqi@0 72
aoqi@0 73 /**
aoqi@0 74 * Human readable name of this type.
aoqi@0 75 */
aoqi@0 76 String fullName();
aoqi@0 77 }

mercurial