[aXSL-commit] SF.net SVN: axsl: [500] trunk/axsl/axsl-fotree/src/java/org/axsl/fotree/FONodeProxy.java

[<vic...@us...>]

Revision: 500
Author:   victormote
Date:     2006-05-04 14:19:26 -0700 (Thu, 04 May 2006)
ViewCVS:  http://svn.sourceforge.net/axsl/?rev=500&view=rev

Log Message:
-----------
Add interface for a proxy that can be embedded in an FONode.

Added Paths:
-----------
    trunk/axsl/axsl-fotree/src/java/org/axsl/fotree/FONodeProxy.java
Added: trunk/axsl/axsl-fotree/src/java/org/axsl/fotree/FONodeProxy.java
===================================================================
--- trunk/axsl/axsl-fotree/src/java/org/axsl/fotree/FONodeProxy.java	                        (rev 0)
+++ trunk/axsl/axsl-fotree/src/java/org/axsl/fotree/FONodeProxy.java	2006-05-04 21:19:26 UTC (rev 500)
@@ -0,0 +1,49 @@
+/*
+ * Copyright 2006 The aXSL Project.
+ *      http://www.axsl.org
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+/* $Id$ */
+
+package org.axsl.fotree;
+
+/**
+ * <p>Interface that allows pluggable extension of FONodes in the FOTree
+ * without the need to subclass.
+ * If subclassing is vertical extension, then FONodeProxy is a horizontal
+ * extension.
+ * FONodeProxy instances serve as proxies for FONode instances, and are
+ * cross-referenced with them.
+ * They can be used by any user of the FOTree to embed references to non-FOTree
+ * data in the FOTree.
+ * For example, a typical use of the FOTree is as input to a layout system that
+ * will create an AreaTree from it.
+ * The layout system can use the FONodeProxy to store layout-related
+ * information.</p>
+ *
+ * <p>More information about the <em>proxy</em> design pattern can be found
+ * in the Gang of Four literature. This specific implementation shares some
+ * characteristics of the Protection Proxy and of the Smart Reference.</p>
+ */
+public interface FONodeProxy {
+
+    /**
+     * Returns the FONode for which this proxy stands.
+     * @return The FONode that is attached to this proxy.
+     */
+    public FONode getFONode() ;
+
+}


Property changes on: trunk/axsl/axsl-fotree/src/java/org/axsl/fotree/FONodeProxy.java
___________________________________________________________________
Name: svn:keywords
   + "Author Id Rev Date URL"
Name: svn:eol-style
   + native


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.