Author: echatellier Date: 2011-01-14 10:08:21 +0100 (Fri, 14 Jan 2011) New Revision: 2180 Url: http://nuiton.org/repositories/revision/topia/2180 Log: Add doc about create(E) method Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/persistence/TopiaDAO.java Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/persistence/TopiaDAO.java =================================================================== --- trunk/topia-persistence/src/main/java/org/nuiton/topia/persistence/TopiaDAO.java 2010-12-30 13:39:58 UTC (rev 2179) +++ trunk/topia-persistence/src/main/java/org/nuiton/topia/persistence/TopiaDAO.java 2011-01-14 09:08:21 UTC (rev 2180) @@ -47,7 +47,6 @@ import org.nuiton.topia.generator.DAOTransformer; import java.security.Permission; -import java.util.Collection; import java.util.List; import java.util.Map; @@ -56,7 +55,7 @@ * create, delete, update or find entities using properties of {@link * TopiaQuery}. * <p/> - * This interface is implemented by {@link TopiaDAOImpl} overriden by generation + * This interface is implemented by {@link TopiaDAOImpl} overridden by generation * from {@link DAOTransformer} for specific entity interface, {@link * DAOAbstractTransformer} for abstract implementation and {@link * DAOImplTransformer} for final implementation class. @@ -85,7 +84,7 @@ * Create a new instance of managed entity. * * @return new entity instance - * @throws TopiaException if any pb while creating the entitie + * @throws TopiaException if any pb while creating the entity * @since 2.3.1 */ E newInstance() throws TopiaException; @@ -186,6 +185,9 @@ /** * Permet de sauver un object instancié sans le DAO. + * Utilisé notement dans le cas ou le DAO est situé derriere une couche + * de webservice et que l'appel à la methode {@link #create(Object...)} + * serait trop couteux. * * @param e l'entité instanciée à sauver * @return l'entité avec son topiaID valorisé @@ -403,7 +405,8 @@ /** * Count the number of entities based on {@code query}. - * + * + * @param query query * @return number of entities filtered by the query * @throws TopiaException if any pb while getting datas * @since 2.3.4