1 /*
2 * Copyright (C) Christian Schulte <cs@schulte.it>, 2005-206
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * o Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 *
12 * o Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in
14 * the documentation and/or other materials provided with the
15 * distribution.
16 *
17 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
18 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
19 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 * $JOMC: ModelProvider.java 5043 2015-05-27 07:03:39Z schulte $
29 *
30 */
31 package org.jomc.modlet;
32
33 /**
34 * {@code Model} provider interface.
35 *
36 * @author <a href="mailto:cs@schulte.it">Christian Schulte</a>
37 * @version $JOMC: ModelProvider.java 5043 2015-05-27 07:03:39Z schulte $
38 * @see ModelContext#findModel(java.lang.String)
39 */
40 public interface ModelProvider
41 {
42
43 /**
44 * Searches a given context for a {@code Model}.
45 *
46 * @param context The context to search for a {@code Model}.
47 * @param model The {@code Model} currently being searched.
48 *
49 * @return The {@code Model} found in the context or {@code null}, if no {@code Model} is found.
50 *
51 * @throws NullPointerException if {@code context} or {@code model} is {@code null}.
52 * @throws ModelException if searching the context fails.
53 */
54 Model findModel( ModelContext context, Model model ) throws NullPointerException, ModelException;
55
56 }