1 /* 2 * Copyright 2003,2004 The Apache Software Foundation. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 /* 17 18 */ 19 20 package org.apache.pluto.portalImpl.services.pageregistry; 21 22 import org.apache.pluto.portalImpl.aggregation.Fragment; 23 import org.apache.pluto.portalImpl.aggregation.RootFragment; 24 import org.apache.pluto.portalImpl.services.Service; 25 26 /** 27 * <P> 28 * The <CODE>PageRegistryService</CODE> interface represents a complete site 29 * with all pages, windows and portlet entries on it. It is accessed 30 * by the datastore layer to get information about the site. 31 * </P> 32 * <P> 33 * The interfaces defined in this package represent an abstract object 34 * model (OM) that is applicable for different implementations. 35 * The abstract OM defines only how the data is stored and accessed 36 * in the memory. Each implementation can store the data in different ways. 37 * </P> 38 * <P> 39 * This abstraction layer helps to generalize the portlet container from 40 * special implementations like data storage and moreover it is not bound 41 * to a special Application Server. 42 * </P> 43 * 44 45 */ 46 public abstract class PageRegistryService extends Service 47 { 48 49 50 /** 51 * Returns the description of the complete portal site. 52 * 53 * @return the object model description 54 */ 55 public abstract RootFragment getRootFragment(); 56 57 /** 58 * Returns the fragment with the given id. 59 * 60 * return the fragment object with this id 61 **/ 62 public abstract Fragment getFragment(String id); 63 64 /** 65 * Add a fragment to the page registry. 66 * 67 * @param fragment the fragment to add 68 **/ 69 public abstract void addFragment(Fragment fragment) throws Exception; 70 } 71