Author: julien(a)jboss.com Date: 2007-12-27 16:30:57 -0500 (Thu, 27 Dec 2007) New Revision: 9395 Modified: branches/presentation/presentation/src/main/org/jboss/portal/presentation/impl/model/container/AssociationContext.java Log: minor javadoc Modified: branches/presentation/presentation/src/main/org/jboss/portal/presentation/impl/model/container/AssociationContext.java =================================================================== --- branches/presentation/presentation/src/main/org/jboss/portal/presentation/impl/model/container/AssociationContext.java 2007-12-27 21:22:27 UTC (rev 9394) +++ branches/presentation/presentation/src/main/org/jboss/portal/presentation/impl/model/container/AssociationContext.java 2007-12-27 21:30:57 UTC (rev 9395) @@ -118,8 +118,19 @@ loaded = false; } - protected abstract StructuralObject doLoad(); + /** + * Loads the related side. + * + * @return the loaded structural object + * @throws StateException if the load operation cannot be achieved + */ + protected abstract StructuralObject doLoad() throws StateException; + /** + * Attempt for loading the related side. If a failure occurs during while loading the related side + * the load operation is aborted and the status of the association owner is updated accordingly. If the loading + * of the related side is succesful the association is updated. + */ private void load() { try @@ -157,7 +168,7 @@ } } - // + // Set as loaded this.loaded = true; } catch (StateException e) @@ -265,7 +276,13 @@ return list; } - protected abstract List<StructuralObject> doLoad(); + /** + * Load the related side. + * + * @return the list of structural objects + * @throws StateException if the load operation cannot be achieved + */ + protected abstract List<StructuralObject> doLoad() throws StateException; private void load() {