Observer.java revision f5597e626ecf7949d249dea08c1a2964d890ec11
172a454cd3513ac24fbdd0e0cb9ad70b86a99b801Kristian Monsen/*
2c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  Licensed to the Apache Software Foundation (ASF) under one or more
3c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  contributor license agreements.  See the NOTICE file distributed with
4c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  this work for additional information regarding copyright ownership.
5731df977c0511bca2206b5f333555b1205ff1f43Iain Merrick *  The ASF licenses this file to You under the Apache License, Version 2.0
6c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  (the "License"); you may not use this file except in compliance with
7c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  the License.  You may obtain a copy of the License at
8ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsen *
9c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *     http://www.apache.org/licenses/LICENSE-2.0
10c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *
11c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  Unless required by applicable law or agreed to in writing, software
12c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  distributed under the License is distributed on an "AS IS" BASIS,
133f50c38dc070f4bb515c1b64450dae14f316474eKristian Monsen *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
143f50c38dc070f4bb515c1b64450dae14f316474eKristian Monsen *  See the License for the specific language governing permissions and
15c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *  limitations under the License.
16c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott */
17c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott
18c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottpackage java.util;
19c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott
20c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott
21731df977c0511bca2206b5f333555b1205ff1f43Iain Merrick/**
22731df977c0511bca2206b5f333555b1205ff1f43Iain Merrick * {@code Observer} is the interface to be implemented by objects that
23c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott * receive notification of updates on an {@code Observable} object.
24c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott *
25c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott * @see Observable
26c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott */
27c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottpublic interface Observer {
28c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott
29c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott    /**
30c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     * This method is called if the specified {@code Observable} object's
31c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     * {@code notifyObservers} method is called (because the {@code Observable}
32c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     * object has been updated.
33c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     *
34c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     * @param observable
35c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     *            the {@link Observable} object.
36c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     * @param data
37c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     *            the data passed to {@link Observable#notifyObservers(Object)}.
38c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott     */
39c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott    void update(Observable observable, Object data);
40c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott}
41c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott