KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > hp > hpl > jena > rdf > model > ModelSpec


1 /*
2   (c) Copyright 2003, 2004, 2005 Hewlett-Packard Development Company, LP
3   [See end of file]
4   $Id: ModelSpec.java,v 1.14 2005/04/10 12:45:49 chris-dollin Exp $
5 */
6
7 package com.hp.hpl.jena.rdf.model;
8
9 /**
10     A ModelSpec allows Models to be created.
11     
12     @author kers
13 */
14 public interface ModelSpec extends ModelSource
15     {
16     /**
17         Answer a Model that fits the specification of this ModelSpec and is built over some
18         underlying model with the given name. [It is not necessary for the resulting model
19         to be known by that name.]
20         
21         <p>NOTE: this method is likely to become deprecated, and then deleted, absent
22         user pressure to retain it.
23     */
24     Model createModelOver( String JavaDoc name );
25     
26     /**
27         Answer an RDF description of this ModelSpec using the JenaModelSpec vocabulary. The
28         description root will be a freshly-created bnode.
29     */
30     Model getDescription();
31     
32     /**
33         Answer an RDF description of this ModelSpec using the JenaModelSpec vocabulary, with
34         the given Resource as root.
35         
36         @param root the resource to be used for all the top-level properties
37         @return a description of this ModelSpec
38     */
39     Model getDescription( Resource root );
40     
41     /**
42         Add this ModelSpec's description to a given model, under the given resource
43         @param m the model to which the description is to be added
44         @param self the resource to which the properties are to be added
45         @return the model m (for cascading and convenience)
46     */
47     Model addDescription( Model m, Resource self );
48     }
49
50
51 /*
52     (c) Copyright 2003, 2004, 2005 Hewlett-Packard Development Company, LP
53     All rights reserved.
54
55     Redistribution and use in source and binary forms, with or without
56     modification, are permitted provided that the following conditions
57     are met:
58
59     1. Redistributions of source code must retain the above copyright
60        notice, this list of conditions and the following disclaimer.
61
62     2. Redistributions in binary form must reproduce the above copyright
63        notice, this list of conditions and the following disclaimer in the
64        documentation and/or other materials provided with the distribution.
65
66     3. The name of the author may not be used to endorse or promote products
67        derived from this software without specific prior written permission.
68
69     THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
70     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
71     OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
72     IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
73     INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
74     NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
75     DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
76     THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
77     (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
78     THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
79 */
Popular Tags