01: /*
02: * Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
03: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
04: *
05: * This code is free software; you can redistribute it and/or modify it
06: * under the terms of the GNU General Public License version 2 only, as
07: * published by the Free Software Foundation. Sun designates this
08: * particular file as subject to the "Classpath" exception as provided
09: * by Sun in the LICENSE file that accompanied this code.
10: *
11: * This code is distributed in the hope that it will be useful, but WITHOUT
12: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14: * version 2 for more details (a copy is included in the LICENSE file that
15: * accompanied this code).
16: *
17: * You should have received a copy of the GNU General Public License version
18: * 2 along with this work; if not, write to the Free Software Foundation,
19: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20: *
21: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22: * CA 95054 USA or visit www.sun.com if you need additional information or
23: * have any questions.
24: */
25:
26: package com.sun.xml.internal.bind.api;
27:
28: /**
29: * Accesses a particular property of a bean.
30: *
31: * <p>
32: * This interface allows JAX-RPC to access an element property of a JAXB bean.
33: *
34: * <p>
35: * <b>Subject to change without notice</b>.
36: *
37: * @author Kohsuke Kawaguchi
38: *
39: * @since 2.0 EA1
40: */
41: public abstract class RawAccessor<B, V> {
42:
43: /**
44: * Gets the value of the property of the given bean object.
45: *
46: * @param bean
47: * must not be null.
48: * @throws AccessorException
49: * if failed to set a value. For example, the getter method
50: * may throw an exception.
51: *
52: * @since 2.0 EA1
53: */
54: public abstract V get(B bean) throws AccessorException;
55:
56: /**
57: * Sets the value of the property of the given bean object.
58: *
59: * @param bean
60: * must not be null.
61: * @param value
62: * the value to be set. Setting value to null means resetting
63: * to the VM default value (even for primitive properties.)
64: * @throws AccessorException
65: * if failed to set a value. For example, the setter method
66: * may throw an exception.
67: *
68: * @since 2.0 EA1
69: */
70: public abstract void set(B bean, V value) throws AccessorException;
71: }
|