//
-// Open Service Platform
// Copyright (c) 2013 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
/**
* @class Pkcs08Attribute
- * @brief This class implements the functionalities specified by the Pkcs08Attribute class. An Attribute object consists
- * of an attribute type (specified by an object identifier) and one or more attribute values. It acts as a
- * container for adding, inserting, removing, encoding X.509 AttributeValue.
+ * @brief This class implements the functionalities specified by the %Pkcs08Attribute class.
+ *
* @since 2.1
*
+ * The %Pkcs08Attribute class implements the functionalities specified by the %Pkcs08Attribute class. An Attribute object consists
+ * of an attribute type (specified by an object identifier) and one or more attribute values. It acts as a
+ * container for adding, inserting, removing, and encoding X.509 AttributeValue.
+ *
*/
class _OSP_EXPORT_ Pkcs08Attribute
virtual ~Pkcs08Attribute(void);
/**
- * Intializes this instance of %Pkcs08Attribute with the Bytebuffer which contain X.509 Attribute @n
- * structure in ASN.1 DER format. @n
+ * Initializes this instance of %Pkcs08Attribute with the specified Tizen::Base::ByteBuffer instance that contains the X.509 attribute
+ * structure in ASN.1 DER format.
*
* @since 2.1
*
* @return An error code
- * @param[in] encodedData DER encoded Bytebuffer of X.509 Attribute structure.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer containing the X.509 attribute structure
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
/**
- * Intializes this instance of %Pkcs08Attribute with specified attribute type.
+ * Initializes this instance of %Pkcs08Attribute with the specified attribute type.
*
* @since 2.1
*
* @return An error code
- * @param[in] attributeType This parameter specifies object Identifier of particular x.509 attribute type. Object IDs @n
- * (e.g. oid for name is 2.5.4.41)are defined by standard bodies for attribute.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] attributeType The object identifier of a particular X.509 attribute type @n
+ * Object IDs (for example, oid for name is 2.5.4.41) are defined by standard attribute bodies.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::String& attributeType);
/**
- * Get the attribute type.
- * This function implements GetAttributeType API which returns the Attribute type of this attribute instance.
+ * Gets the attribute type. @n
+ * The %GetAttributeType() method implements GetAttributeType that returns the attribute type of this attribute instance.
*
* @since 2.1
*
- * @return Containing the Object ID of Attribute Type in string format like 2.5.4.41
+ * @return The string with the object ID of attribute type like 2.5.4.41
*
*/
Tizen::Base::String GetAttributeType(void) const;
/**
- * This function adds attribute value in the attribute value list.
+ * Adds the attribute value in the attribute value list.
*
* @since 2.1
*
* @return An error code
- * @param[in] attributeValue An instance of Pkcs08AttributeValue to add an attribute in the list.
+ * @param[in] attributeValue An instance of Pkcs08AttributeValue
*/
result AddAttributeValue(const Pkcs08AttributeValue& attributeValue);
/**
- * This function remove attribute value in the attribute value list.
+ * Removes the attribute value from the attribute value list.
*
* @since 2.1
*
* @return An error code
- * @param[in] attributeValue An instance of Pkcs08AttributeValue to remove an attribute in the list.
+ * @param[in] attributeValue An instance of Pkcs08AttributeValue
*/
result RemoveAttributeValue(const Pkcs08AttributeValue& attributeValue);
/**
- * This function returns the array list containing the attribute values of type Pkcs08AttributeValue.
+ * Gets an array list containing the attribute values of type Pkcs08AttributeValue.
*
* @since 2.1
*
- * @return A reference to an ArrayList containing the list of Attribute values.
+ * @return A reference to an ArrayList containing the list of attribute values
*/
const Tizen::Base::Collection::ArrayList& GetAttributeValues(void) const;
/**
- * Gets the encoded form of the Pkcs08Attribute.
- * It is assumed that each Pkcs08Attribute will have only a single form of encoding example ASN.1 DER.
+ * Gets the encoded form of Pkcs08Attribute.
+ * It is assumed that each %Pkcs08Attribute will have only a single form of encoding, for example ASN.1 DER.
*
* @since 2.1
*
- * @return A pointer to the ByteBuffer class that contains the output, @n
- * else @c null if an error occurs
+ * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * else @c null if an error occurs
*
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.