User: ecrutchfield Date: 06/04/09 06:49:14 Modified: andromda-nspring/src/main/resources/templates/nspring NSpringHibernateDaoImplManual.vsl NSpringHibernateDaoBase.vsl NSpringHibernateDaoImpl.vsl NSpringDaoInterface.vsl Log: convert comments to .Net style Revision Changes Path 1.2 +9 -12 cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringHibernateDaoImplManual.vsl Index: NSpringHibernateDaoImplManual.vsl =================================================================== RCS file: /cvsroot/andromdaplugins/cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringHibernateDaoImplManual.vsl,v retrieving revision 1.1 retrieving revision 1.2 diff -u -w -r1.1 -r1.2 --- NSpringHibernateDaoImplManual.vsl 8 Mar 2006 04:18:42 -0000 1.1 +++ NSpringHibernateDaoImplManual.vsl 9 Apr 2006 13:49:12 -0000 1.2 @@ -2,7 +2,7 @@ // Name: ${entity.daoImplementationName}.cs // license-header cs merge-point // -// This is only generated once! It will never be overwritten. +// This is only generated once by NSpringHibernateDaoImplManual.vsl! It will never be overwritten. // You can (and have to!) safely modify it by hand. using System; @@ -13,7 +13,7 @@ #end #set ($superclass = $entity.generalization) /// <summary> - /// @see $entity.fullyQualifiedName + /// <see cref="$entity.fullyQualifiedName"/> /// </summary> public class $entity.daoImplementationName : $entity.fullyQualifiedDaoBaseName { @@ -22,38 +22,35 @@ #set ($returnObject = "returnValue") #set ($signature = $operation.implementationSignature) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#${operation.getSignature(false)} + /// <see cref="${entity.fullyQualifiedDaoName.operation.getSignature(false)}"/> /// </summary> protected override $returnType.fullyQualifiedName $signature -#if ($operation.exceptionsPresent) - throws $operation.exceptionList -#end { - //@todo implement $operation.visibility $returnType.fullyQualifiedName $signature + //${toDoTag} implement $operation.visibility $returnType.fullyQualifiedName $signature #if ($operation.returnTypePresent) return $operation.returnType.javaNullString; #else - throw new InvalidOperationException("${entity.fullyQualifiedName}.${signature} Not implemented!"); + throw new NotImplementedException("${entity.fullyQualifiedName}.${signature} Not implemented!"); #end } #end #foreach ($valueObjectRef in $entity.valueObjectReferences) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#${valueObjectRef.transformationMethodName}($entity.fullyQualifiedName) + /// <see cref="${entity.fullyQualifiedDaoName.valueObjectRef.transformationMethodName}($entity.fullyQualifiedName)"/> /// </summary> public override $valueObjectRef.targetElement.fullyQualifiedName ${valueObjectRef.transformationMethodName}($entity.fullyQualifiedName entity) { - // put your implementation here + //${toDoTag} put your implementation here return null; } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#${valueObjectRef.transformationToEntityMethodName}($valueObjectRef.targetElement.fullyQualifiedName) + /// <see cref="${entity.fullyQualifiedDaoName.valueObjectRef.transformationToEntityMethodName}($valueObjectRef.targetElement.fullyQualifiedName)"/> /// </summary> public override $entity.fullyQualifiedEntityName ${valueObjectRef.transformationToEntityMethodName}($valueObjectRef.targetElement.fullyQualifiedName $stringUtils.uncapitalize($valueObjectRef.name)) { - // put your implementation here + //${toDoTag} put your implementation here return null; } 1.3 +40 -42 cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringHibernateDaoBase.vsl Index: NSpringHibernateDaoBase.vsl =================================================================== RCS file: /cvsroot/andromdaplugins/cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringHibernateDaoBase.vsl,v retrieving revision 1.2 retrieving revision 1.3 diff -u -w -r1.2 -r1.3 --- NSpringHibernateDaoBase.vsl 25 Mar 2006 03:48:53 -0000 1.2 +++ NSpringHibernateDaoBase.vsl 9 Apr 2006 13:49:12 -0000 1.3 @@ -42,7 +42,7 @@ /// objects of type <code>$entity.fullyQualifiedEntityName</code>. /// </p> /// - /// @see $entity.fullyQualifiedEntityName + /// <see cref="$entity.fullyQualifiedEntityName"/> /// </summary> public abstract class $entity.daoBaseName #if($superEntity) @@ -79,7 +79,7 @@ #set ($identifier = $entity.identifiers.iterator().next()) #set ($argumentName = $stringUtils.uncapitalize($entity.name)) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Load(int, $identifier.type.fullyQualifiedName) + /// <see cref="${entity.fullyQualifiedDaoName}.Load(int, $identifier.type.fullyQualifiedName)"/> /// </summary> public $inheritanceModifierAllEntityMethod Object Load(int transform, $identifier.type.fullyQualifiedName $identifier.name) { @@ -98,7 +98,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Load($identifier.type.fullyQualifiedName) + /// <see cref="${entity.fullyQualifiedDaoName}.Load($identifier.type.fullyQualifiedName)"/> /// </summary> public $inheritanceModifierAllEntityMethod $entity.root.fullyQualifiedEntityName Load($identifier.type.fullyQualifiedName $identifier.name) { @@ -106,7 +106,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#LoadAll() + /// <see cref="${entity.fullyQualifiedDaoName}.LoadAll()"/> /// </summary> public $inheritanceModifierAllEntityMethod System.Collections.IList LoadAll() { @@ -114,7 +114,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#LoadAll(int) + /// <see cref="${entity.fullyQualifiedDaoName}.LoadAll(int)" /> /// </summary> public $inheritanceModifierAllEntityMethod System.Collections.IList LoadAll(int transform) { @@ -126,7 +126,7 @@ ## Only add these methods if the entity isn't abstract #if (!$entity.abstract) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Create($entity.fullyQualifiedEntityName) + /// <see cref="${entity.fullyQualifiedDaoName}.Create($entity.fullyQualifiedEntityName)"/> /// </summary> public virtual $entity.root.fullyQualifiedEntityName Create($entity.fullyQualifiedEntityName $argumentName) { @@ -134,7 +134,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Create(int transform, $entity.fullyQualifiedEntityName) + /// <see cref="${entity.fullyQualifiedDaoName}.Create(int transform, $entity.fullyQualifiedEntityName)"/> /// </summary> public virtual Object Create(int transform, $entity.fullyQualifiedName $argumentName) { @@ -148,7 +148,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Create(System.Collections.ICollection) + /// <see cref="${entity.fullyQualifiedDaoName}.Create(System.Collections.ICollection)"/> /// </summary> public $inheritanceModifierConcreteEntityMethod System.Collections.ICollection Create(System.Collections.ICollection entities) { @@ -156,7 +156,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Create(int, System.Collections.ICollection) + /// <see cref="${entity.fullyQualifiedDaoName}.Create(int, System.Collections.ICollection)"/> /// </summary> public $inheritanceModifierConcreteEntityMethod System.Collections.ICollection Create(int transform, System.Collections.ICollection entities) { @@ -179,7 +179,7 @@ #set ($attributes = $entity.getAttributes(true,false)) #if (!$attributes.empty) /// <summary> - /// @see ${entity.root.fullyQualifiedDaoName}#Create(${entity.getAttributeTypeList(true, false)}) + /// <see cref="${entity.root.fullyQualifiedDaoName}.Create(${entity.getAttributeTypeList(true, false)})"/> /// </summary> public virtual $entity.root.fullyQualifiedEntityName Create( #foreach($attribute in $attributes) @@ -191,7 +191,7 @@ } /// <summary> - /// @see ${entity.root.fullyQualifiedDaoName}#Create(int, ${entity.getAttributeTypeList(true, false)}) + /// <see cref="${entity.root.fullyQualifiedDaoName}.Create(int, ${entity.getAttributeTypeList(true, false)})"/> /// </summary> public virtual Object Create( int transform, @@ -211,7 +211,7 @@ #set ($requiredProperties = $entity.getRequiredProperties(true,false)) #if (!$requiredProperties.empty && $entity.getRequiredAttributes(true,false).size() != $requiredProperties.size()) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Create(${entity.getRequiredPropertyTypeList(true, false)}) + /// <see cref="${entity.fullyQualifiedDaoName}.Create(${entity.getRequiredPropertyTypeList(true, false)})"/> /// </summary> public virtual $entity.root.fullyQualifiedEntityName Create( #foreach($property in $requiredProperties) @@ -223,7 +223,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Create(int, ${entity.getRequiredPropertyTypeList(true, false)}) + /// <see cref="${entity.fullyQualifiedDaoName}.Create(int, ${entity.getRequiredPropertyTypeList(true, false)})"/> /// </summary> public virtual Object Create( int transform, @@ -243,7 +243,7 @@ #end #end /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Update($entity.fullyQualifiedEntityName) + /// <see cref="${entity.fullyQualifiedDaoName}.Update($entity.fullyQualifiedEntityName)"/> /// </summary> public virtual void Update($entity.fullyQualifiedEntityName $argumentName) { @@ -256,7 +256,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Update(System.Collections.ICollection) + /// <see cref="${entity.fullyQualifiedDaoName}.Update(System.Collections.ICollection)"/> /// </summary> public $inheritanceModifierAllEntityMethod void Update(System.Collections.ICollection entities) { @@ -273,7 +273,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Remove($entity.fullyQualifiedEntityName) + /// <see cref="${entity.fullyQualifiedDaoName}.Remove($entity.fullyQualifiedEntityName)"/> /// </summary> public virtual void Remove($entity.fullyQualifiedEntityName $argumentName) { @@ -286,7 +286,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Remove($identifier.type.fullyQualifiedName) + /// <see cref="${entity.fullyQualifiedDaoName}.Remove($identifier.type.fullyQualifiedName)"/> /// </summary> public $inheritanceModifierAllEntityMethod void Remove($identifier.type.fullyQualifiedName $identifier.name) { @@ -312,7 +312,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#Remove(System.Collections.ICollection) + /// <see cref="${entity.fullyQualifiedDaoName}.Remove(System.Collections.ICollection)"/> /// </summary> public $inheritanceModifierAllEntityMethod void Remove(System.Collections.ICollection entities) { @@ -328,7 +328,7 @@ #foreach ($finder in $entity.getQueryOperations(true)) #set ($returnType = $finder.returnType.fullyQualifiedName) /// <summary> - /// @see ${entity.fullyQualifiedName}#$finder.getSignature(false) + /// <see cref="${entity.fullyQualifiedName}.$finder.getSignature(false)"/> /// </summary> $finder.visibility $returnType $finder.signature #if ($finder.exceptionsPresent) @@ -344,7 +344,7 @@ #if(!$finder.criteriaFinder) /// <summary> - /// @see ${entity.fullyQualifiedName}#${finder.name}(String#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end) + /// <see cref="${entity.fullyQualifiedName}.${finder.name}(String#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end)"/> /// </summary> $finder.visibility $returnType ${finder.name}(String queryString#if(!$finder.arguments.empty), ${finder.getTypedArgumentList()}#end) #if ($finder.exceptionsPresent) @@ -362,7 +362,7 @@ #set ($returnType = "Object") #end /// <summary> - /// @see ${entity.fullyQualifiedName}#${finder.name}(int#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end) + /// <see cref="${entity.fullyQualifiedName}.${finder.name}(int#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end)"/> /// </summary> $finder.visibility $returnType ${finder.name}(int transform#if(!$finder.arguments.empty), ${finder.getTypedArgumentList()}#end) #if ($finder.exceptionsPresent) @@ -373,7 +373,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedName}#${finder.name}(int, String#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end) + /// <see cref="${entity.fullyQualifiedName}.${finder.name}(int, String#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end)"/> /// </summary> $finder.visibility $returnType ${finder.name}(int transform, String queryString#if(!$finder.arguments.empty), ${finder.getTypedArgumentList()}#end) #if ($finder.exceptionsPresent) @@ -428,7 +428,7 @@ } #else /// <summary> - /// @see ${entity.fullyQualifiedName}#${finder.name}(int, String#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end) + /// <see cref="${entity.fullyQualifiedName}.${finder.name}(int, String#if(!$finder.arguments.empty), ${finder.argumentTypeNames}#end)"/> /// </summary> $finder.visibility $returnType ${finder.name}(int transform#if(!$finder.arguments.empty), ${finder.getTypedArgumentList()}#end) #if ($finder.exceptionsPresent) @@ -491,7 +491,7 @@ #set ($returnType = $operation.returnType) #set ($signature = $operation.signature) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#${operation.getSignature(false)} + /// <see cref="${entity.fullyQualifiedDaoName}.${operation.getSignature(false)}"/> /// </summary> $operation.visibility $returnType.fullyQualifiedName ${operation.name}(${operation.getTypedArgumentList()}) #if ($operation.exceptionsPresent) @@ -518,7 +518,7 @@ } /// <summary> - /// Performs the core logic for {@link #${operation.getSignature(false)}} + /// Performs the core logic for <seealso cref="#${operation.getSignature(false)}"/> /// </summary> protected abstract $operation.returnType.fullyQualifiedName $operation.implementationSignature; @@ -527,26 +527,25 @@ /// Allows transformation of entities into value objects /// (or something else for that matter), when the <code>transform</code> /// flag is set to one of the constants defined in <code>$entity.fullyQualifiedDaoName</code>, please note - /// that the {@link #$daoNoTransformationEnumName} constant denotes no transformation, so the entity itself + /// that the <seealso cref="#$daoNoTransformationEnumName"/> constant denotes no transformation, so the entity itself /// will be returned. #if (!$entity.valueObjectReferences.empty) /// <p/> /// This method will return instances of these types: /// <ul> - /// <li>{@link $entity.fullyQualifiedName} - {@link #$daoNoTransformationEnumName}</li> + /// <li><seealso cref="$entity.fullyQualifiedName"/> - <seealso cref="#$daoNoTransformationEnumName"/></li> #foreach ($valueObjectRef in $entity.valueObjectReferences) #set ($targetElement = $valueObjectRef.targetElement) - /// <li>{@link $targetElement.fullyQualifiedName} - {@link ${valueObjectRef.transformationConstantName}}</li> + /// <li><seealso cref="$targetElement.fullyQualifiedName"/> - <seealso cref="${valueObjectRef.transformationConstantName}"/></li> #end /// </ul> #end /// - /// If the integer argument value is unknown {@link #${entity.daoNoTransformationConstantName}} is assumed. + /// If the integer argument value is unknown <seealso cref="${entity.daoNoTransformationConstantName}"/> is assumed. /// - /// @param transform one of the constants declared in {@link $entity.fullyQualifiedDaoName} - /// @param entity an entity that was found - /// @return the transformed entity (i.e. new value object, etc) - /// @see #TransformEntities(int,System.Collections.ICollection) + /// <param name="transform">one of the constants declared in <seealso cref="$entity.fullyQualifiedDaoName"/></param> + /// <param name="entity">an entity that was found</param> + /// <returns>the transformed entity (i.e. new value object, etc) <see cref="#TransformEntities(int,System.Collections.ICollection)"/></returns> /// </summary> protected Object TransformEntity(int transform, $entity.fullyQualifiedName entity) { @@ -584,14 +583,13 @@ /// <summary> /// Transforms a collection of entities using the - /// {@link #TransformEntity(int,$entity.fullyQualifiedName)} method. + /// <seealso cref="#TransformEntity(int,$entity.fullyQualifiedName)"/> method. /// <p/> /// This method is to be used internally only. /// - /// @param transform one of the constants declared in <code>$entity.fullyQualifiedDaoName</code> - /// @param entities the collection of entities to transform - /// @return a new list containing the transformed entities - /// @see #TransformEntity(int,$entity.fullyQualifiedName) + /// <param name="transform">one of the constants declared in <code>$entity.fullyQualifiedDaoName</code></param> + /// <param name="entities">the collection of entities to transform</param> + /// <returns>a new list containing the transformed entities <see cref="#TransformEntity(int,$entity.fullyQualifiedName)"/></returns> /// </summary> protected $inheritanceModifierAllEntityMethod System.Collections.IList TransformEntities(int transform, System.Collections.ICollection entities) { @@ -616,7 +614,7 @@ #foreach ($valueObjectRef in $entity.valueObjectReferences) /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#${valueObjectRef.transformationToListMethodName}(System.Collections.ICollection) + /// <see cref="${entity.fullyQualifiedDaoName}.${valueObjectRef.transformationToListMethodName}(System.Collections.ICollection)"/> /// </summary> public System.Collections.IList ${valueObjectRef.transformationToListMethodName}(System.Collections.ICollection entities) { @@ -634,8 +632,8 @@ /// <summary> /// Base implementation for transforming the results of a report query into a value object. This /// implementation exists for convenience reasons only. It needs only be overridden in the - /// {@link $entity.daoImplementationName} class if you intend to use reporting queries. - /// @see ${entity.fullyQualifiedDaoName}#${valueObjectRef.transformationMethodName}($entity.fullyQualifiedName) + /// <seealso cref="$entity.daoImplementationName"/> class if you intend to use reporting queries. + /// <see cref="${entity.fullyQualifiedDaoName}.${valueObjectRef.transformationMethodName}($entity.fullyQualifiedName)"/> /// </summary> protected $valueObjectRef.targetElement.fullyQualifiedName ${valueObjectRef.transformationMethodName}(Object[] row) { @@ -643,7 +641,7 @@ } /// <summary> - /// @see ${entity.fullyQualifiedDaoName}#${valueObjectRef.transformationToEntityListMethodName}(System.Collections.ICollection) + /// <see cref="${entity.fullyQualifiedDaoName}.${valueObjectRef.transformationToEntityListMethodName}(System.Collections.ICollection)"/> /// </summary> public System.Collections.IList ${valueObjectRef.transformationToEntityListMethodName}(System.Collections.ICollection instances) { 1.2 +1 -1 cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringHibernateDaoImpl.vsl Index: NSpringHibernateDaoImpl.vsl =================================================================== RCS file: /cvsroot/andromdaplugins/cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringHibernateDaoImpl.vsl,v retrieving revision 1.1 retrieving revision 1.2 diff -u -w -r1.1 -r1.2 --- NSpringHibernateDaoImpl.vsl 8 Mar 2006 04:18:42 -0000 1.1 +++ NSpringHibernateDaoImpl.vsl 9 Apr 2006 13:49:12 -0000 1.2 @@ -13,7 +13,7 @@ #end #set ($superclass = $entity.generalization) /// <summary> - /// @see $entity.fullyQualifiedName + /// <see cref="$entity.fullyQualifiedName"/> /// </summary> public class $entity.daoImplementationName : $entity.fullyQualifiedDaoBaseName { 1.2 +26 -27 cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringDaoInterface.vsl Index: NSpringDaoInterface.vsl =================================================================== RCS file: /cvsroot/andromdaplugins/cartridges/andromda-nspring/src/main/resources/templates/nspring/NSpringDaoInterface.vsl,v retrieving revision 1.1 retrieving revision 1.2 diff -u -w -r1.1 -r1.2 --- NSpringDaoInterface.vsl 8 Mar 2006 04:18:42 -0000 1.1 +++ NSpringDaoInterface.vsl 9 Apr 2006 13:49:12 -0000 1.2 @@ -32,14 +32,14 @@ #end #foreach ($valueObjectRef in $entity.valueObjectReferences) - // Transform into objects of type {@link $valueObjectRef.targetElement.fullyQualifiedName}. + // Transform into objects of type <seealso cref="$valueObjectRef.targetElement.fullyQualifiedName"/>. $valueObjectRef.transformationConstantName = $valueObjectRef.transformationConstantValue#if($velocityCount != $entity.valueObjectReferences.size()),#end #end } /// <summary> - /// @see $entity.fullyQualifiedEntityName + /// <see cref="$entity.fullyQualifiedEntityName"/> /// </summary> public interface $entity.daoName #if($superEntity) @@ -50,22 +50,22 @@ { #foreach ($valueObjectRef in $entity.valueObjectReferences) /// <summary> - /// Converts this DAO's entity to an object of type {@link $valueObjectRef.targetElement.fullyQualifiedName}. + /// Converts this DAO's entity to an object of type <seealso cref="$valueObjectRef.targetElement.fullyQualifiedName"/>. /// </summary> $valueObjectRef.targetElement.fullyQualifiedName ${valueObjectRef.transformationMethodName}($entity.fullyQualifiedEntityName entity); /// <summary> - /// Converts this DAO's entity collection to a list of instances of type {@link $valueObjectRef.targetElement.fullyQualifiedName}. + /// Converts this DAO's entity collection to a list of instances of type <seealso cref="$valueObjectRef.targetElement.fullyQualifiedName"/>. /// </summary> System.Collections.IList ${valueObjectRef.transformationToListMethodName}(System.Collections.ICollection entities); /// <summary> - /// Converts an instance of type {@link $valueObjectRef.targetElement.fullyQualifiedName} to this DAO's entity. + /// Converts an instance of type <seealso cref="$valueObjectRef.targetElement.fullyQualifiedName"/> to this DAO's entity. /// </summary> $entity.fullyQualifiedEntityName ${valueObjectRef.transformationToEntityMethodName}($valueObjectRef.targetElement.fullyQualifiedName $stringUtils.uncapitalize($valueObjectRef.name)); /// <summary> - /// Converts a collection of instances of type {@link $valueObjectRef.targetElement.fullyQualifiedName} to this DAO's entity list. + /// Converts a collection of instances of type <seealso cref="$valueObjectRef.targetElement.fullyQualifiedName"/> to this DAO's entity list. /// </summary> System.Collections.IList ${valueObjectRef.transformationToEntityListMethodName}(System.Collections.ICollection instances); @@ -80,7 +80,7 @@ /// <summary> /// <p> - /// Does the same thing as {@link #Load($identifier.type.fullyQualifiedName)} with an + /// Does the same thing as <seealso cref="#Load($identifier.type.fullyQualifiedName)"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// the returned entity will <strong>NOT</strong> be transformed. If this flag is any of the other constants /// defined in this class then the result <strong>WILL BE</strong> passed through an operation which can @@ -88,21 +88,21 @@ /// not occur. /// </p> /// - /// @param $identifier.name the identifier of the entity to load. - /// @return either the entity or the object transformed from the entity. + /// <param name="$identifier.name">the identifier of the entity to load.</param> + /// <returns>either the entity or the object transformed from the entity.</returns> /// </summary> Object Load(int transform, $identifier.type.fullyQualifiedName $identifier.name); /// <summary> - /// Loads all entities of type {@link ${entity.fullyQualifiedEntityName}}. + /// Loads all entities of type <seealso cref="${entity.fullyQualifiedEntityName}"/>. /// - /// @return the loaded entities. + /// <returns>the loaded entities.</returns> /// </summary> System.Collections.IList LoadAll(); /// <summary> /// <p> - /// Does the same thing as {@link #LoadAll()} with an + /// Does the same thing as <seealso cref="#LoadAll()"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// the returned entity will <strong>NOT</strong> be transformed. If this flag is any of the other constants /// defined here then the result <strong>WILL BE</strong> passed through an operation which can optionally @@ -110,8 +110,8 @@ /// not occur. /// </p> /// - /// @param transform the flag indicating what transformation to use. - /// @return the loaded entities. + /// <param name="transform">the flag indicating what transformation to use.</param> + /// <returns>the loaded entities.</returns> /// </summary> System.Collections.IList LoadAll(int transform); @@ -125,7 +125,7 @@ /// <summary> /// <p> - /// Does the same thing as {@link #Create($entity.fullyQualifiedEntityName)} with an + /// Does the same thing as <seealso cref="#Create($entity.fullyQualifiedEntityName)"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// the returned entity will <strong>NOT</strong> be transformed. If this flag is any of the other constants /// defined here then the result <strong>WILL BE</strong> passed through an operation which can optionally @@ -140,16 +140,15 @@ /// Creates a new instance of $entity.fullyQualifiedEntityName and adds /// from the passed in <code>entities</code> collection /// - /// @param entities the collection of $entity.fullyQualifiedEntityName - /// instances to create. + /// <param name="entities">the collection of $entity.fullyQualifiedEntityName instances to create.</param> /// - /// @return the created instances. + /// <returns>the created instances.</returns> /// </summary> System.Collections.ICollection Create(System.Collections.ICollection entities); /// <summary> /// <p> - /// Does the same thing as {@link #Create($entity.fullyQualifiedEntityName)} with an + /// Does the same thing as <seealso cref="#Create($entity.fullyQualifiedEntityName)"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// the returned entity will <strong>NOT</strong> be transformed. If this flag is any of the other constants /// defined here then the result <strong>WILL BE</strong> passed through an operation which can optionally @@ -178,7 +177,7 @@ /// <summary> /// <p> - /// Does the same thing as {@link #Create($entity.getAttributeTypeList(true,false))} with an + /// Does the same thing as <seealso cref="#Create($entity.getAttributeTypeList(true,false))"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// the returned entity will <strong>NOT</strong> be transformed. If this flag is any of the other constants /// defined here then the result <strong>WILL BE</strong> passed through an operation which can optionally @@ -211,7 +210,7 @@ /// <summary> /// <p> - /// Does the same thing as {@link #Create($entity.getRequiredAttributeTypeList(true,false))} with an + /// Does the same thing as <seealso cref="#Create($entity.getRequiredAttributeTypeList(true,false))"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// the returned entity will <strong>NOT</strong be transformed. If this flag is any of the other constants /// defined here then the result <strong>WILL BE</strong> passed through an operation which can optionally @@ -274,9 +273,9 @@ #if(!$operation.criteriaFinder) /// <summary> /// <p> - /// Does the same thing as {@link #${operation.getSignature(false)}} with an + /// Does the same thing as <seealso cref="#${operation.getSignature(false)}"/> with an /// additional argument called <code>queryString</code>. This <code>queryString</code> - /// argument allows you to override the query string defined in {@link #${operation.getSignature(false)}}. + /// argument allows you to override the query string defined in <seealso cref="#${operation.getSignature(false)}"/>. /// </p> /// </summary> #if ($operation.exceptionsPresent) @@ -291,7 +290,7 @@ #end /// <summary> /// <p> - /// Does the same thing as {@link #${operation.getSignature(false)}} with an + /// Does the same thing as <seealso cref="#${operation.getSignature(false)}"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// finder results will <strong>NOT</strong> be transformed during retrieval. /// If this flag is any of the other constants defined here @@ -309,9 +308,9 @@ /// <summary> /// <p> - /// Does the same thing as {@link #${operation.name}(boolean#if(!$operation.arguments.empty), ${operation.argumentTypeNames}#end)} with an + /// Does the same thing as <seealso cref="#${operation.name}(boolean#if(!$operation.arguments.empty), ${operation.argumentTypeNames}#end)"/> with an /// additional argument called <code>queryString</code>. This <code>queryString</code> - /// argument allows you to override the query string defined in {@link #${operation.name}(int#if(!$operation.arguments.empty), ${operation.typedArgumentList}#end)}. + /// argument allows you to override the query string defined in <seealso cref="#${operation.name}(int#if(!$operation.arguments.empty), ${operation.typedArgumentList}#end)"/>. /// </p> /// </summary> #if ($operation.exceptionsPresent) @@ -323,7 +322,7 @@ #else /// <summary> /// <p> - /// Does the same thing as {@link #${operation.getSignature(false)}} with an + /// Does the same thing as <seealso cref="#${operation.getSignature(false)}"/> with an /// additional flag called <code>transform</code>. If this flag is set to <code>$daoNoTransformationEnumName</code> then /// finder results will <strong>NOT</strong> be transformed during retrieval. /// If this flag is any of the other constants defined here |