From 66ddf14b735e6bea73aca0e1fffe43ccfe0a63b1 Mon Sep 17 00:00:00 2001 From: Kegan Myers Date: Fri, 28 Feb 2014 10:45:35 -0600 Subject: [PATCH] Document GenericResponse, remove SetdData, bump version --- README.md | 3 ++ bower.json | 2 +- lib/Typertext/GenericRequest.ts | 2 +- lib/Typertext/GenericResponse.ts | 54 +++++++++++++++++++++++++++++--- package.json | 2 +- 5 files changed, 56 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 490a1ba..7530ae7 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,9 @@ This project is licensed under the MIT license, the text of which can be read in Changelog --------- +####0.3.0 +- Removed SetData from GenericResponse +- Added documentation ####0.2.1 - Renamed some functions - Pulled decoding of URL encoded objects into own function diff --git a/bower.json b/bower.json index 41bbdbe..bc2cc6f 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "Typertext", - "version": "0.2.1", + "version": "0.3.0", "homepage": "https://github.com/terribleplan/Typertext", "authors": [ "Kegan Myers " diff --git a/lib/Typertext/GenericRequest.ts b/lib/Typertext/GenericRequest.ts index 8e14072..ee976a4 100644 --- a/lib/Typertext/GenericRequest.ts +++ b/lib/Typertext/GenericRequest.ts @@ -17,7 +17,7 @@ module Typertext { * @uses Typertext.Http.HttpUrl * * @author Kegan Myers - * @version 0.2.1 + * @version 0.3.0 */ export interface GenericRequest>> { diff --git a/lib/Typertext/GenericResponse.ts b/lib/Typertext/GenericResponse.ts index d17776f..42bed9c 100644 --- a/lib/Typertext/GenericResponse.ts +++ b/lib/Typertext/GenericResponse.ts @@ -1,3 +1,8 @@ +/** + * @module Typertext + * @submodule Http + * @submodule Json + */ module Typertext { import HttpHeaderData = Typertext.Http.HttpHeaderData; import HttpResponseStatus = Typertext.Http.HttpResponseStatus; @@ -8,6 +13,22 @@ module Typertext { private httpStatus:number; private content:T; + /** + * A common way to specify a response that gets passed between classes and eventually returned to the user + * + * @class GenericResponse + * @uses Typertext.Http.HttpHeaderData + * @uses Typertext.Http.HttpResponseStatus + * + * @param {HttpResponseStatus} status + * @param {HttpHeaderData} responseHeaders + * @param {number} httpResponseCode + * @param {T} responseBody + * @constructor + * + * @author Kegan Myers + * @version 0.3.0 + */ constructor(status:HttpResponseStatus, responseHeaders?:HttpHeaderData, httpResponseCode?:number, responseBody?:T) { this.status = status; this.headers = responseHeaders; @@ -15,28 +36,53 @@ module Typertext { this.content = responseBody; } + /** + * Accessor method + * + * @returns {T} + */ public GetContent():T { return this.content; } + /** + * Accessor method + * + * @returns {string} + * @constructor + */ public GetContentType():string { return this.GetHeaders()["Content-Type"]; } + /** + * Accessor method + * + * @returns {HttpHeaderData} + * @constructor + */ public GetHeaders():HttpHeaderData { return this.headers; } + /** + * Accessor method + * + * @returns {number} + * @constructor + */ public GetHttpStatus():number { return this.httpStatus; } + /** + * Accessor method + * + * @returns {HttpResponseStatus} + * @constructor + */ public GetStatus():HttpResponseStatus { return this.status; } - - public SetContent(content:T):void { - this.content = content; - } } } \ No newline at end of file diff --git a/package.json b/package.json index 4f97c1f..309684b 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,7 @@ "type" : "git", "url" : "https://github.com/terribleplan/Typertext.git" }, - "version": "0.2.1", + "version": "0.3.0", "devDependencies": { "grunt": "~0.4.2", "grunt-typescript": "~0.2.7"