001 //$HeadURL: https://svn.wald.intevation.org/svn/deegree/base/branches/2.3_testing/src/org/deegree/framework/xml/schema/ComplexTypeDeclaration.java $ 002 /*---------------------------------------------------------------------------- 003 This file is part of deegree, http://deegree.org/ 004 Copyright (C) 2001-2009 by: 005 Department of Geography, University of Bonn 006 and 007 lat/lon GmbH 008 009 This library is free software; you can redistribute it and/or modify it under 010 the terms of the GNU Lesser General Public License as published by the Free 011 Software Foundation; either version 2.1 of the License, or (at your option) 012 any later version. 013 This library is distributed in the hope that it will be useful, but WITHOUT 014 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 015 FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more 016 details. 017 You should have received a copy of the GNU Lesser General Public License 018 along with this library; if not, write to the Free Software Foundation, Inc., 019 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 020 021 Contact information: 022 023 lat/lon GmbH 024 Aennchenstr. 19, 53177 Bonn 025 Germany 026 http://lat-lon.de/ 027 028 Department of Geography, University of Bonn 029 Prof. Dr. Klaus Greve 030 Postfach 1147, 53001 Bonn 031 Germany 032 http://www.geographie.uni-bonn.de/deegree/ 033 034 e-mail: info@deegree.org 035 ----------------------------------------------------------------------------*/ 036 package org.deegree.framework.xml.schema; 037 038 import java.util.LinkedHashSet; 039 040 import org.deegree.datatypes.QualifiedName; 041 042 /** 043 * Represents an XML complex type declaration in an {@link XMLSchema}. 044 * <p> 045 * The following limitations apply: 046 * <ul> 047 * <li>the type may be defined using 'extension', but must not use 'restriction'</li> 048 * <li>the content model must be a sequence</li> 049 * </ul> 050 * </p> 051 * 052 * @author <a href="mailto:schneider@lat-lon.de">Markus Schneider </a> 053 * @author last edited by: $Author: mschneider $ 054 * 055 * @version $Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18. Jun 2009) $ 056 */ 057 public class ComplexTypeDeclaration implements TypeDeclaration { 058 059 private QualifiedName name; 060 061 private TypeReference extensionBaseType; 062 063 private ElementDeclaration[] subElements; 064 065 /** 066 * Creates a new <code>ComplexTypeDeclaration</code> instance from the given parameters. 067 * 068 * @param name 069 * @param extensionBaseType 070 * @param subElements 071 */ 072 public ComplexTypeDeclaration( QualifiedName name, TypeReference extensionBaseType, 073 ElementDeclaration[] subElements ) { 074 this.name = name; 075 this.extensionBaseType = extensionBaseType; 076 this.subElements = subElements; 077 } 078 079 /** 080 * Returns the qualified name of the declared XML type. 081 * 082 * @return the qualified name of the declared XML type 083 */ 084 public QualifiedName getName() { 085 return this.name; 086 } 087 088 /** 089 * Returns a {@link TypeReference} to the XML type that this complex type extends. 090 * 091 * @return a TypeReference to the XML type that this complex type extends 092 */ 093 public TypeReference getExtensionBaseType() { 094 return this.extensionBaseType; 095 } 096 097 /** 098 * Returns the {@link ElementDeclaration}s that this {@link ComplexTypeDeclaration} 099 * contains, but not the ones that are inherited (from the extended type). 100 * 101 * @return the explicit ElementDeclarations in this ComplexTypeDeclaration 102 */ 103 public ElementDeclaration[] getExplicitElements() { 104 return this.subElements; 105 } 106 107 /** 108 * Returns the {@link ElementDeclaration}s in this {@link ComplexTypeDeclaration} 109 * contains, this includes the ones that are inherited (from the extended type). 110 * 111 * @return the explicit+implicit ElementDeclarations in this ComplexTypeDeclaration 112 */ 113 public ElementDeclaration[] getElements() { 114 LinkedHashSet<ElementDeclaration> allElementSet = new LinkedHashSet<ElementDeclaration>(); 115 addElements( allElementSet ); 116 return allElementSet.toArray( new ElementDeclaration[allElementSet.size()] ); 117 } 118 119 /** 120 * Returns a string representation of the object. 121 * 122 * @return a string representation of the object 123 */ 124 @Override 125 public String toString() { 126 return toString( "" ); 127 } 128 129 /** 130 * Returns a string representation of the object (indented for better readablity, 131 * as this is a hierarchical structure). 132 * 133 * @param indent 134 * current indentation (as a whitespace string) 135 * @return an indented string representation of the object 136 */ 137 public String toString( String indent ) { 138 StringBuffer sb = new StringBuffer(); 139 sb.append( indent ); 140 sb.append( "- complexType" ); 141 if ( name != null ) { 142 sb.append( " name=\"" ); 143 sb.append( this.name ); 144 sb.append( "\"" ); 145 } 146 if ( this.extensionBaseType != null ) { 147 sb.append( ", extension base=\"" ); 148 sb.append( this.extensionBaseType.getName() ); 149 sb.append( "\"" ); 150 } 151 sb.append( "\n" ); 152 for (int i = 0; i < subElements.length; i++) { 153 sb.append( subElements[i].toString( indent 154 + " " ) ); 155 } 156 return sb.toString(); 157 } 158 159 /** 160 * Recursively collects all <code>ElementDeclaration</code>s that this 161 * <code>ComplexType</code> has. 162 * <p> 163 * Respects order and scope (overwriting) of <code>ElementDeclaration</code>s. 164 * 165 * @param elementSet 166 * the inherited (and own) elements are added to this LinkedHashSet 167 */ 168 private void addElements( LinkedHashSet<ElementDeclaration> elementSet ) { 169 if ( this.extensionBaseType != null 170 && this.extensionBaseType.getTypeDeclaration() != null ) { 171 ( (ComplexTypeDeclaration) this.extensionBaseType.getTypeDeclaration() ) 172 .addElements( elementSet ); 173 } 174 for (int i = 0; i < subElements.length; i++) { 175 elementSet.add( this.subElements[i] ); 176 } 177 } 178 }