xml.schema/javahelp/org/netbeans/modules/xml/schema/tasks/applyingdesignpatterns.html
author Milutin Kristofic <mkristofic@netbeans.org>
Tue, 31 Jan 2017 14:20:36 +0100
changeset 1584 ddcac47bfed1
parent 1241 f7c3471c4a3f
permissions -rw-r--r--
Added Missing license terms
samaresh@338
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
samaresh@338
     2
<!--
mkristofic@1584
     3
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
mkristofic@1584
     4
mkristofic@1584
     5
Copyright 2009-2017 Oracle and/or its affiliates. All rights reserved.
mkristofic@1584
     6
mkristofic@1584
     7
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
mkristofic@1584
     8
Other names may be trademarks of their respective owners.
mkristofic@1584
     9
mkristofic@1584
    10
The contents of this file are subject to the terms of either the GNU
mkristofic@1584
    11
General Public License Version 2 only ("GPL") or the Common
mkristofic@1584
    12
Development and Distribution License("CDDL") (collectively, the
mkristofic@1584
    13
"License"). You may not use this file except in compliance with the
mkristofic@1584
    14
License. You can obtain a copy of the License at
mkristofic@1584
    15
http://www.netbeans.org/cddl-gplv2.html
mkristofic@1584
    16
or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
mkristofic@1584
    17
specific language governing permissions and limitations under the
mkristofic@1584
    18
License.  When distributing the software, include this License Header
mkristofic@1584
    19
Notice in each file and include the License file at
mkristofic@1584
    20
nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
mkristofic@1584
    21
particular file as subject to the "Classpath" exception as provided
mkristofic@1584
    22
by Oracle in the GPL Version 2 section of the License file that
mkristofic@1584
    23
accompanied this code. If applicable, add the following below the
mkristofic@1584
    24
License Header, with the fields enclosed by brackets [] replaced by
mkristofic@1584
    25
your own identifying information:
mkristofic@1584
    26
"Portions Copyrighted [year] [name of copyright owner]"
mkristofic@1584
    27
mkristofic@1584
    28
Contributor(s):
mkristofic@1584
    29
mkristofic@1584
    30
The Original Software is NetBeans. The Initial Developer of the Original
mkristofic@1584
    31
Software is Sun Microsystems, Inc. Portions Copyright 2009-2010 Sun
mkristofic@1584
    32
Microsystems, Inc. All Rights Reserved.
mkristofic@1584
    33
mkristofic@1584
    34
If you wish your version of this file to be governed by only the CDDL
mkristofic@1584
    35
or only the GPL Version 2, indicate your decision by adding
mkristofic@1584
    36
"[Contributor] elects to include this software in this distribution
mkristofic@1584
    37
under the [CDDL or GPL Version 2] license." If you do not indicate a
mkristofic@1584
    38
single choice of license, a recipient has the option to distribute
mkristofic@1584
    39
your version of this file under either the CDDL, the GPL Version 2 or
mkristofic@1584
    40
to extend the choice of license to its licensees as provided above.
mkristofic@1584
    41
However, if you add GPL Version 2 code and therefore, elected the GPL
mkristofic@1584
    42
Version 2 license, then the option applies only if the new code is
mkristofic@1584
    43
made subject to such option by the copyright holder.
samaresh@338
    44
-->
samaresh@338
    45
<html>
samaresh@338
    46
<head>
psmejkal@1107
    47
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
samaresh@338
    48
<link rel="stylesheet" href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css" type="text/css">
samaresh@338
    49
<title>Applying a Design Pattern to an XML Schema</title>
samaresh@338
    50
</head>
samaresh@338
    51
<body>
samaresh@338
    52
<h2><a name="cshid"></a>Applying a Design Pattern to an XML Schema</h2>
samaresh@338
    53
<p><small><a href="#seealso">See Also</a></small></p>
samaresh@338
    54
<p>You can use XML schema tools to apply one of the following design patterns to an XML schema file:</p>
samaresh@338
    55
<ul>
samaresh@338
    56
<li><b>Venetian Blind.</b> In the Venetian Blind design, there is a single global element; all other elements are local. Element declarations are nested within a single global declaration, using named complex types and element groups. Complex types and element groups can be reused throughout the schema. Only the root element must be defined within the global namespace.</li>
samaresh@338
    57
<li><b>Russian Doll.</b> In the Russian Doll design, there is a single global element; all other elements are local. Element declarations are nested within a single global declaration and element declarations can only be used once. Only the root element must be defined within the global namespace.</li>
samaresh@338
    58
<li><b>Garden of Eden.</b> The Garden of Eden design is a combination of the Venetian Blind and Salami Slice designs. All elements and types are defined in the global namespace with the elements referenced as needed.</li>
samaresh@338
    59
<li><b>Salami Slice.</b> In the Salami Slice design, all elements are global. There is no nesting of element declarations and element declarations can be reused throughout the schema. All elements must be defined within the global namespace.</li>
samaresh@338
    60
</ul>
samaresh@338
    61
<p><b>To apply a design pattern to an XML schema file:</b></p>
samaresh@338
    62
<ol>
samaresh@338
    63
<li>In the Projects window, select the node of the XML schema file.</li>
samaresh@338
    64
<li>Right-click and choose Apply Design Pattern.<br>
samaresh@338
    65
The Apply Design Pattern dialog box opens. <br>
samaresh@338
    66
<ul class="note">
samaresh@338
    67
<li>If your schema is invalid, not well-formed, or empty, you will see an error message in the lower part of the dialog box and you will not be able to proceed until you fix or populate the schema file. In this case, click Cancel, fix or populate the schema file, and try again.</li>
samaresh@338
    68
</ul>
samaresh@338
    69
The Apply Design Pattern dialog box has the following components:<br>
samaresh@338
    70
<ul>
samaresh@338
    71
<li><b>Global Element</b> and <b>Type</b> radio buttons. Combinations of these settings let you select the design pattern to apply. </li>
samaresh@338
    72
<li><b>Selected Design Pattern.</b> Shows the name of the design pattern you selected.</li>
samaresh@338
    73
<li><b>Current Design Pattern.</b> Shows the name of the design pattern currently applied to your schema.</li>
samaresh@338
    74
<li>Pattern description. Shows the description of the design pattern you selected.</li>
samaresh@338
    75
<li><b>Example.</b> Shows an example of the design pattern.</li>
samaresh@338
    76
</ul></li>
samaresh@338
    77
<li>Select the appropriate radio buttons to select the design pattern to apply.<br>
samaresh@338
    78
As you make your selections, information and error messages appear in the lower part of the dialog box.</li>
samaresh@338
    79
<li>Click Finish.<br>
samaresh@338
    80
The IDE applies the new design pattern to your XML schema file.</li>
samaresh@338
    81
</ol>
samaresh@338
    82
samaresh@338
    83
<dl>
samaresh@338
    84
<dt><a name="seealso">See Also</a></dt>
samaresh@338
    85
<dd><a href="validatingxmlschema.html" title="Validating XML Schema Files">Validating XML Schema Files</a></dd>
samaresh@338
    86
<dd><a href="../about.html" title="About XML Schema Tools">About XML Schema Tools</a></dd>
samaresh@338
    87
</dl>
samaresh@338
    88
<hr>
samaresh@338
    89
<small><a href="../credits.html">Legal Notices</a></small>
samaresh@338
    90
<table cellpadding="150" border="0"> 
samaresh@338
    91
<tr><td>&nbsp;</td></tr> 
samaresh@338
    92
<tr><td>&nbsp;</td></tr> 
samaresh@338
    93
<tr><td>&nbsp;</td></tr> 
samaresh@338
    94
</table> 
samaresh@338
    95
</body>
samaresh@338
    96
</html>