diff --git a/19_decorators.md b/19_decorators.md
index 91f2cc5..7271689 100644
--- a/19_decorators.md
+++ b/19_decorators.md
@@ -131,6 +131,8 @@ f(): called
4. 对于类，将应用 *类装饰器* （ *Class Decorators* are applied for the class ）。
+
+<a name="class-decorators"></a>
### 类装饰器
*类装饰器* 是在类声明之前、紧接着类声明处使用的。类声明作用与类的构造器，而可用于对类的定义进行观察、修改或替换。类装饰器不能在声明文件，或任何其它外围上下文中使用（比如在某个`declare`类上。The class decorator is applied to the constructor of the class and can be used to observe, modify or replace a class definition. A class decorator cannot be used in a declaration file, or in any other ambient context(such as on a `declare` class)）。
@@ -194,6 +196,7 @@ class Greeter {
console.log(new Greeter("world"));
```
+<a name="method-decorators"></a>
### 方法装饰器（Method Decorators）
*方法装饰器* 是在某个方法声明之前、紧接着该方法处使用的。此种装饰器被应用到方法的 *属性描述符* ，而可用于对方法定义进行观察、修改或替换。不能在定义文件、过载或任何其它已有上下文中（比如某个`declare`类中）使用方法装饰器（The decorator is applied to the *Property Descriptor* for the method, and can be used to observe, modify, or replace a method definition. A method decorator cannot be used in a declaration file, on an overload, or in any other ambient context(such as in a `declare` class)）。
@@ -245,6 +248,7 @@ console.log(g.greet());
这里的`@enumerable(false)`装饰器是一个装饰器工厂。在`@enumerable(false)`装饰器被调用时，其就对属性描述符的`enumberable`属性，进行修改。
+<a name="accessor-decorators"></a>
### 访问器装饰器（Accessor Decorators）
*访问器装饰器* 是在紧接着某个访问器声明之前进行声明的。访问器装饰器是应用到该访问器的 *属性描述符（the Property Descriptor）* 上的，且可用于对某个访问器的定义进行观察、修改或替换。在定义文件、或其他任何外围上下文（比如某个`declare`的类）中，都不能使用访问器的装饰器。
@@ -293,7 +297,7 @@ function configurable (value: boolean) {
}
```
-
+<a name="property-decorators"></a>
### 属性装饰器（Property Decorators）
*属性装饰器* 是紧接着某个属性声明之前进行声明的。在声明文件中，以及任何其他外围上下文（比如在某个`declare`类中），都不能使用属性装饰器。
@@ -344,4 +348,73 @@ function getFormat (target: any, propertyKey: string) {
}
```
-这里的装饰器 `@format("Hello, %s")`是一个 [装饰器工厂](#decorator-factories)
+这里的装饰器 `@format("Hello, %s")`是一个 [装饰器工厂](#decorator-factories) 。在调用`@format("Hello, %s")`时，该函数就使用`reflect-metadata`库`Reflect.metadata`函数，添加该属性`greeting`的一个元数据条目。在调用`getFormat`时，`getFormat`函数就读取到那个格式的元数据值了。
+
+> **注意** 此示例需要`reflect-metadata`库。请参阅 [元数据](#metadata) 部分了解有关 `reflect-metadata`库更多的信息。
+
+
+<a name="parameter-decorators"></a>
+### 参数装饰器（parameter decorators）
+
+*参数装饰器*，是紧接着某个参数声明之前进行声明的。参数装饰器应用到类构造器或类的方法声明的函数上的（the parameter decorator is applied to the function for a class constructor or method declaration）。参数装饰器不能用在声明文件（`.d.ts`）、重载（overload）或其他外围上下文（ambient context，比如在某个`declare`类中）。
+
+参数装饰器的表达式在运行时将作为函数加以调用，其有着以下三个参数：
+
+1. 静态成员的类的构造函数，或实例成员的类的原型；
+
+2. 成员的名称；
+
+3. 对应参数在函数参数列表中的顺序索引。
+
+> **注意** 参数装饰器只能用于对某个方法上已声明的某个参数进行观察（A parameter decorator can only be used to observe that a parameter has been declared on a method）。
+
+以下是一个参数装饰器（`@required`）的示例，该参数装饰器应用到`Greeter`类的成员的参数上：
+
+```typescript
+class Greeter {
+ greeting: string;
+
+ constructor(message: string) {
+ this.greeting = message;
+ }
+
+ @validate
+ greet(@required name: string) {
+ return "Hello " + name + ", " + this.greeting;
+ }
+}
+```
+
+可使用下面的函数声明，来定义出`@required`与`@validate`两个装饰器：
+
+```typescript
+import "reflect-metadata";
+
+let requiredMetadataKey: Symbol;
+
+function required(target: Object, propertyKey: string | symbol, parameterIndex: number) {
+ let existingRequiredParameters: number[] = Reflect.getOwnMetadata(requiredMetadataKey, target, propertyKey) || [];
+
+ existingRequiredParameters.push(parameterIndex);
+ Reflect.defineMetadata(requiredMetadataKey, existingRequiredParameters, target, propertyKey);
+}
+
+function validate (target: any, propertyName: string, descriptor: TypedPropertyDescriptor<Function>) {
+ let method = descriptor.value;
+
+ descriptor.value = function () {
+ let requiredParameters: number[] = Reflect.getOwnMetadata(requiredMetadataKey, target, propertyName);
+
+ if(requiredParameters) {
+ for ( let parameterIndex of requiredParameters ) {
+ if (parameterIndex >= arguments.length || arguments[parameterIndex] === undefined) {
+ throw new Error("缺少需要的参数。");
+ }
+ }
+ }
+
+ return method.apply(this, arguments);
+ }
+}
+```
+
diff --git a/src/class_decorators.ts b/src/class_decorators.ts
new file mode 100644
index 0000000..3df7579
--- /dev/null
+++ b/src/class_decorators.ts
@@ -0,0 +1,23 @@
+'use strict';
+
+// 访问器装饰器，Accessor Decorator
+class Point {
+ private _x: number;
+ private _y: number;
+ constructor(x: number, y: number) {
+ this._x = x;
+ this._y = y;
+ }
+
+ @configurable(false)
+ get x() { return this._x; }
+
+ @configurable(false)
+ get y() { return this._y; }
+}
+
+function configurable(value: boolean) {
+ return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+ descriptor.configurable = value;
+ };
+}
diff --git a/src/parameter_decorators.ts b/src/parameter_decorators.ts
new file mode 100644
index 0000000..b5bc214
--- /dev/null
+++ b/src/parameter_decorators.ts
@@ -0,0 +1,44 @@
+import "reflect-metadata";
+
+class Greeter {
+ greeting: string;
+
+ constructor(message: string) {
+ this.greeting = message;
+ }
+
+ @validate
+ greet(@required name: string) {
+ return "Hello " + name + ", " + this.greeting;
+ }
+}
+
+let requiredMetadataKey: Symbol;
+
+function required(target: Object, propertyKey: string | symbol, parameterIndex: number) {
+ let existingRequiredParameters: number[] = Reflect.getOwnMetadata(requiredMetadataKey, target, propertyKey) || [];
+
+ existingRequiredParameters.push(parameterIndex);
+ Reflect.defineMetadata(requiredMetadataKey, existingRequiredParameters, target, propertyKey);
+}
+
+function validate (target: any, propertyName: string, descriptor: TypedPropertyDescriptor<Function>) {
+ let method = descriptor.value;
+
+ descriptor.value = function () {
+ let requiredParameters: number[] = Reflect.getOwnMetadata(requiredMetadataKey, target, propertyName);
+
+ if(requiredParameters) {
+ for ( let parameterIndex of requiredParameters ) {
+ if (parameterIndex >= arguments.length || arguments[parameterIndex] === undefined) {
+ throw new Error("缺少需要的参数。");
+ }
+ }
+ }
+
+ return method.apply(this, arguments);
+ }
+}
+
+let g = new Greeter("早上好");
+console.log(g.greet("Echo Feng"));
diff --git a/src/main.ts b/src/property_decorators.ts
similarity index 57%
rename from src/main.ts
rename to src/property_decorators.ts
index 4159fba..88d2168 100644
--- a/src/main.ts
+++ b/src/property_decorators.ts
@@ -1,28 +1,5 @@
-'use strict';
import "reflect-metadata";
-// 访问器装饰器，Accessor Decorator
-class Point {
- private _x: number;
- private _y: number;
- constructor(x: number, y: number) {
- this._x = x;
- this._y = y;
- }
-
- @configurable(false)
- get x() { return this._x; }
-
- @configurable(false)
- get y() { return this._y; }
-}
-
-function configurable(value: boolean) {
- return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
- descriptor.configurable = value;
- };
-}
-
// 属性装饰器，property decorator
class Greeter {
@format("Hello, %s")
diff --git a/tsconfig.json b/tsconfig.json
index 8c9e402..2340acb 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,6 +1,6 @@
{
- "files": [
- "src/main.ts"
+ "include": [
+ "src/*.ts"
],
"compilerOptions": {
"noImplicitAny": true,