From efb2529a5089da79b1bfb06b816019fa7b249595 Mon Sep 17 00:00:00 2001
From: Steve Hu <stevehu@gmail.com>
Date: Tue, 15 Dec 2020 14:19:46 -0500
Subject: [PATCH] fixes #154 splite openapi-meta to move specification parser
 to openapi-helper (#155)

---
 openapi-helper/pom.xml                        |  62 ++
 .../networknt/openapi/ApiNormalisedPath.java  |   0
 .../com/networknt/openapi/NormalisedPath.java |   0
 .../com/networknt/openapi/OpenApiHelper.java  |   0
 .../networknt/openapi/OpenApiOperation.java   |   0
 .../networknt/openapi/OpenApiHelperTest.java  |   0
 .../test/resources/config/client.truststore   | Bin 0 -> 885 bytes
 .../src/test/resources/config/openapi.json    | 293 ++++++
 .../src/test/resources/config/openapi.yaml    | 840 ++++++++++++++++++
 .../src/test/resources/logback-test.xml       |  72 ++
 openapi-meta/pom.xml                          |   4 +
 .../parameter/ParameterDeserializer.java      |   1 -
 pom.xml                                       |   6 +
 13 files changed, 1277 insertions(+), 1 deletion(-)
 create mode 100644 openapi-helper/pom.xml
 rename {openapi-meta => openapi-helper}/src/main/java/com/networknt/openapi/ApiNormalisedPath.java (100%)
 rename {openapi-meta => openapi-helper}/src/main/java/com/networknt/openapi/NormalisedPath.java (100%)
 rename {openapi-meta => openapi-helper}/src/main/java/com/networknt/openapi/OpenApiHelper.java (100%)
 rename {openapi-meta => openapi-helper}/src/main/java/com/networknt/openapi/OpenApiOperation.java (100%)
 rename {openapi-meta => openapi-helper}/src/test/java/com/networknt/openapi/OpenApiHelperTest.java (100%)
 create mode 100644 openapi-helper/src/test/resources/config/client.truststore
 create mode 100644 openapi-helper/src/test/resources/config/openapi.json
 create mode 100644 openapi-helper/src/test/resources/config/openapi.yaml
 create mode 100644 openapi-helper/src/test/resources/logback-test.xml

diff --git a/openapi-helper/pom.xml b/openapi-helper/pom.xml
new file mode 100644
index 00000000..b08a1d05
--- /dev/null
+++ b/openapi-helper/pom.xml
@@ -0,0 +1,62 @@
+<!--
+  ~ Copyright (c) 2016 Network New Technologies Inc.
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>com.networknt</groupId>
+        <artifactId>light-rest-4j</artifactId>
+        <version>2.0.22-SNAPSHOT</version>
+        <relativePath>..</relativePath>
+    </parent>
+
+    <artifactId>openapi-helper</artifactId>
+    <packaging>jar</packaging>
+    <description>An OpenAPI Specification 3.0 helper to cache the spec for other component to use</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.networknt</groupId>
+            <artifactId>json-overlay</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.networknt</groupId>
+            <artifactId>openapi-parser</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-api</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+</project>
diff --git a/openapi-meta/src/main/java/com/networknt/openapi/ApiNormalisedPath.java b/openapi-helper/src/main/java/com/networknt/openapi/ApiNormalisedPath.java
similarity index 100%
rename from openapi-meta/src/main/java/com/networknt/openapi/ApiNormalisedPath.java
rename to openapi-helper/src/main/java/com/networknt/openapi/ApiNormalisedPath.java
diff --git a/openapi-meta/src/main/java/com/networknt/openapi/NormalisedPath.java b/openapi-helper/src/main/java/com/networknt/openapi/NormalisedPath.java
similarity index 100%
rename from openapi-meta/src/main/java/com/networknt/openapi/NormalisedPath.java
rename to openapi-helper/src/main/java/com/networknt/openapi/NormalisedPath.java
diff --git a/openapi-meta/src/main/java/com/networknt/openapi/OpenApiHelper.java b/openapi-helper/src/main/java/com/networknt/openapi/OpenApiHelper.java
similarity index 100%
rename from openapi-meta/src/main/java/com/networknt/openapi/OpenApiHelper.java
rename to openapi-helper/src/main/java/com/networknt/openapi/OpenApiHelper.java
diff --git a/openapi-meta/src/main/java/com/networknt/openapi/OpenApiOperation.java b/openapi-helper/src/main/java/com/networknt/openapi/OpenApiOperation.java
similarity index 100%
rename from openapi-meta/src/main/java/com/networknt/openapi/OpenApiOperation.java
rename to openapi-helper/src/main/java/com/networknt/openapi/OpenApiOperation.java
diff --git a/openapi-meta/src/test/java/com/networknt/openapi/OpenApiHelperTest.java b/openapi-helper/src/test/java/com/networknt/openapi/OpenApiHelperTest.java
similarity index 100%
rename from openapi-meta/src/test/java/com/networknt/openapi/OpenApiHelperTest.java
rename to openapi-helper/src/test/java/com/networknt/openapi/OpenApiHelperTest.java
diff --git a/openapi-helper/src/test/resources/config/client.truststore b/openapi-helper/src/test/resources/config/client.truststore
new file mode 100644
index 0000000000000000000000000000000000000000..ded19d0cdfacba00842ff28296dd589e9889ef96
GIT binary patch
literal 885
zcmezO_TO6u1_mY|W(3o0#i>PQsYO7pO|YeY8Ut&Do~eN)0|T>}K@+o)K@*eI0%j&g
zCMK4EUu!cAc-c6$+C196^D;7WvoaV&8*&?PvN4CUun9A{I~npB@PIfR!mPn1i6yCq
zyawDLKD#iBb7o1UA&&tUh|49+>|c}))5$H&<R5A%WFP>NVixAi$xlwq$;dA*F_07I
zH8eIbG_*7{F)}wbiW28F0&&fuT-sXR#HfVqSw>a{<|amd27@L>E~X|%MuuH!GGZ5|
zbnd(UqEJttZEweoXhtddR*g09%T}<y?U=_>b^EiIa}?{w6gT(GB$rz8$^t%Tu2pV@
zyF+C5a6jPLXnSdv-{pEv>%Zbt>Z~3XM=BS(|L_nh`!mHgfX|tI=Cx1Kh12?9G2Ys)
z^lxH-<c+Cvsvapd8)}Pn-RdM+lkfR053X-HcRc(4<Ks3GEvs(6@0&jFPkZkBWgZJ>
zGTnS(UwI~``|6j^%b#9WnJc#Yg^FGH!s%w2`t$k4XS1rXOikBRstbD8*tbQzzVN-o
zF*~ycC6x)U>J)y@dK$BLspt-N_S%;0+fNsSUG>U7wr1wlkOa-DKYN~aFE)|O@olbJ
zx7C!1nUR4JIfQ`80T@Dz49V8%!N%6Fe!qDl_@2Rg()HXG{&`#Vr9!%-&d&+<vi_vr
z=_8r@`^;tQgY(-nWQ%NbbT*1JJXsy~YUUid#9ccJ!|i=nUtWIqq2k%eT%E>^DwSJf
zaxG`>6SHPGb?I$(@A3adm(@HgrFb>n`Gcolxh%dox>ig5+GlZJ59Lew9Q+T$ze}7v
zw@5)bYrE0hyVtL1$er9H;3)fdPWP$2MppKh+y{=`&zT?bevNL%q~nvP-r$v)B+@S|
z?3KIyaHuSE_`QI$C1<4Wf1d6a%=#`Qa=*o+{67<m8&&!)EIjX^bg@1E6@!@GmW0PH
zb94+dZiF6lVGi&3;5g}9+#+#@1z}6)u)cEtCVZ!L)}JK`CkmG|-x5AEee3!*0L3mp
AJOBUy

literal 0
HcmV?d00001

diff --git a/openapi-helper/src/test/resources/config/openapi.json b/openapi-helper/src/test/resources/config/openapi.json
new file mode 100644
index 00000000..6ce06347
--- /dev/null
+++ b/openapi-helper/src/test/resources/config/openapi.json
@@ -0,0 +1,293 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "version": "1.0.0",
+    "title": "Swagger Petstore",
+    "license": {
+      "name": "MIT"
+    }
+  },
+  "servers": [
+    {
+      "url": "http://petstore.swagger.io/v1"
+    }
+  ],
+  "paths": {
+    "/pets": {
+      "get": {
+        "summary": "List all pets",
+        "operationId": "listPets",
+        "tags": [
+          "pets"
+        ],
+        "parameters": [
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "How many items to return at one time (max 100)",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "security": [
+          {
+            "petstore_auth": [
+              "read:pets"
+            ]
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "An paged array of pets",
+            "headers": {
+              "x-next": {
+                "description": "A link to the next page of responses",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                },
+                "example": [
+                  {
+                    "id": 1,
+                    "name": "catten",
+                    "tag": "cat"
+                  },
+                  {
+                    "id": 2,
+                    "name": "doggy",
+                    "tag": "dog"
+                  }
+                ]
+              }
+            }
+          },
+          "default": {
+            "description": "unexpected error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "Create a pet",
+        "operationId": "createPets",
+        "requestBody": {
+          "description": "Pet to add to the store",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Pet"
+              }
+            }
+          }
+        },
+        "tags": [
+          "pets"
+        ],
+        "security": [
+          {
+            "petstore_auth": [
+              "read:pets",
+              "write:pets"
+            ]
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Null response"
+          },
+          "default": {
+            "description": "unexpected error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/pets/{petId}": {
+      "get": {
+        "summary": "Info for a specific pet",
+        "operationId": "showPetById",
+        "tags": [
+          "pets"
+        ],
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "required": true,
+            "description": "The id of the pet to retrieve",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "security": [
+          {
+            "petstore_auth": [
+              "read:pets"
+            ]
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Expected response to a valid request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                },
+                "example": {
+                  "id": 1,
+                  "name": "Jessica Right",
+                  "tag": "pet"
+                }
+              }
+            }
+          },
+          "default": {
+            "description": "unexpected error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "Delete a specific pet",
+        "operationId": "deletePetById",
+        "tags": [
+          "pets"
+        ],
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "required": true,
+            "description": "The id of the pet to delete",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "key",
+            "in": "header",
+            "required": true,
+            "description": "The key header",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "security": [
+          {
+            "petstore_auth": [
+              "write:pets"
+            ]
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Expected response to a valid request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "default": {
+            "description": "unexpected error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "securitySchemes": {
+      "petstore_auth": {
+        "type": "oauth2",
+        "description": "This API uses OAuth 2 with the client credential grant flow.",
+        "flows": {
+          "clientCredentials": {
+            "tokenUrl": "https://localhost:6882/token",
+            "scopes": {
+              "write:pets": "modify pets in your account",
+              "read:pets": "read your pets"
+            }
+          }
+        }
+      }
+    },
+    "schemas": {
+      "Pet": {
+        "required": [
+          "id",
+          "name"
+        ],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          },
+          "tag": {
+            "type": "string"
+          }
+        }
+      },
+      "Error": {
+        "required": [
+          "code",
+          "message"
+        ],
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/openapi-helper/src/test/resources/config/openapi.yaml b/openapi-helper/src/test/resources/config/openapi.yaml
new file mode 100644
index 00000000..f9ec7b5d
--- /dev/null
+++ b/openapi-helper/src/test/resources/config/openapi.yaml
@@ -0,0 +1,840 @@
+openapi: 3.0.0
+info:
+  version: 1.0.0
+  title: Swagger Petstore
+  license:
+    name: MIT
+servers:
+  - url: 'http://petstore.swagger.io/v1'
+paths:
+  /pets:
+    get:
+      summary: List all pets
+      operationId: listPets
+      tags:
+        - pets
+      parameters:
+        - name: limit
+          in: query
+          description: How many items to return at one time (max 100)
+          required: false
+          schema:
+            type: integer
+            format: int32
+        - name: id_form
+          in: query
+          required: false
+          style: form
+          explode: false
+          schema:
+            type: array
+            items:
+              type: string
+        - name: id_sd
+          in: query
+          required: false
+          style: spaceDelimited
+          explode: false
+          schema:
+            type: array
+            items:
+              type: string
+        - name: id_pd
+          in: query
+          required: false
+          style: pipeDelimited
+          explode: false
+          schema:
+            type: array
+            items:
+              type: string              
+        - name: id_do
+          in: query
+          required: false
+          style: deepObject
+          explode: true
+          schema:
+            $ref: '#/components/schemas/Pet'  
+        - name: id_fo
+          in: query
+          required: false
+          style: form
+          explode: true
+          schema:
+            $ref: '#/components/schemas/Pet'   
+        - name: id_fno
+          in: query
+          required: false
+          style: form
+          explode: false
+          schema:
+            $ref: '#/components/schemas/Pet'                         
+                            
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: An paged array of pets
+          headers:
+            x-next:
+              description: A link to the next page of responses
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Pet'
+              example:
+                - id: 1
+                  name: catten
+                  tag: cat
+                - id: 2
+                  name: doggy
+                  tag: dog
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+    post:
+      summary: Create a pet
+      operationId: createPets
+      requestBody:
+        description: Pet to add to the store
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Pet'
+      tags:
+        - pets
+      security:
+        - petstore_auth:
+            - 'read:pets'
+            - 'write:pets'
+      responses:
+        '201':
+          description: Null response
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+
+  '/pets/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            type: string
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+    delete:
+      summary: Delete a specific pet
+      operationId: deletePetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to delete
+          schema:
+            type: string
+        - name: key
+          in: header
+          required: true
+          description: The key header
+          schema:
+            type: string
+      security:
+        - petstore_auth:
+            - 'write:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_simple_array/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_simple_obj_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          explode: true
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_simple_obj_no_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_label_array_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: label
+          explode: true
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'                
+  '/pets_label_array_no_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: label
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'  
+  '/pets_label_obj_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: label
+          explode: true
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'                
+  '/pets_label_obj_no_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: label
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'                  
+  '/pets_matrix_pm/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: matrix
+          explode: true
+          schema:
+            type: string
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'  
+  '/pets_matrix_array_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: matrix
+          explode: true
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'                
+  '/pets_matrix_array_no_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: matrix
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'  
+  '/pets_matrix_obj_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: matrix
+          explode: true
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'                
+  '/pets_matrix_obj_no_ep/{petId}':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          description: The id of the pet to retrieve
+          style: matrix
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'  
+  '/pets_header_array':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: header
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_header_obj_ep':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: header
+          required: true
+          description: The id of the pet to retrieve
+          explode: true
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_header_obj_no_ep':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: header
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_cookie_array':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: cookie
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            type: array
+            items:
+              type: string  
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  '/pets_cookie_obj_no_ep':
+    get:
+      summary: Info for a specific pet
+      operationId: showPetById
+      tags:
+        - pets
+      parameters:
+        - name: petId
+          in: cookie
+          required: true
+          description: The id of the pet to retrieve
+          schema:
+            $ref: '#/components/schemas/Pet'
+                         
+      security:
+        - petstore_auth:
+            - 'read:pets'
+      responses:
+        '200':
+          description: Expected response to a valid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Pet'
+              example:
+                id: 1
+                name: Jessica Right
+                tag: pet
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+components:
+  securitySchemes:
+    petstore_auth:
+      type: oauth2
+      description: This API uses OAuth 2 with the client credential grant flow.
+      flows:
+        clientCredentials:
+          tokenUrl: 'https://localhost:6882/token'
+          scopes:
+            'write:pets': modify pets in your account
+            'read:pets': read your pets
+  schemas:
+    Pet:
+      type: object
+      required:
+        - id
+        - name
+      properties:
+        id:
+          type: integer
+          format: int64
+        name:
+          type: string
+        tag:
+          type: string
+    Error:
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: integer
+          format: int32
+        message:
+          type: string
diff --git a/openapi-helper/src/test/resources/logback-test.xml b/openapi-helper/src/test/resources/logback-test.xml
new file mode 100644
index 00000000..be7a0492
--- /dev/null
+++ b/openapi-helper/src/test/resources/logback-test.xml
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Copyright (c) 2016 Network New Technologies Inc.
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<configuration>
+    TODO create logger for audit only.
+    http://stackoverflow.com/questions/2488558/logback-to-log-different-messages-to-two-files
+    <turboFilter class="ch.qos.logback.classic.turbo.MarkerFilter">
+        <Marker>PROFILER</Marker>
+        <!--<OnMatch>DENY</OnMatch>-->
+        <OnMatch>NEUTRAL</OnMatch>
+    </turboFilter>
+
+    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
+    <!-- encoders are assigned the type
+         ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5marker %-5level %logger{36} - %msg%n</pattern>
+        </encoder>
+    </appender>
+
+    <appender name="log" class="ch.qos.logback.core.FileAppender">
+        <File>target/test.log</File>
+        <Append>false</Append>
+        <layout class="ch.qos.logback.classic.PatternLayout">
+            <Pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %class{36}:%L %M - %msg%n</Pattern>
+        </layout>
+    </appender>
+
+    <!--audit log-->
+    <appender name="audit" class="ch.qos.logback.core.rolling.RollingFileAppender">
+        <file>target/audit.log</file> <!-- logfile location -->
+        <encoder>
+            <pattern>%-5level [%thread] %date{ISO8601} %F:%L - %msg%n</pattern> <!-- the layout pattern used to format log entries -->
+            <immediateFlush>true</immediateFlush>
+        </encoder>
+        <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
+            <fileNamePattern>target/audit.log.%i.zip</fileNamePattern>
+            <minIndex>1</minIndex>
+            <maxIndex>5</maxIndex> <!-- max number of archived logs that are kept -->
+        </rollingPolicy>
+        <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
+            <maxFileSize>200MB</maxFileSize> <!-- The size of the logfile that triggers a switch to a new logfile, and the current one archived -->
+        </triggeringPolicy>
+    </appender>
+
+    <root level="info">
+        <appender-ref ref="stdout" />
+    </root>
+
+    <logger name="com.networknt" level="info">
+        <appender-ref ref="log"/>
+    </logger>
+
+    <logger name="Audit" level="info" additivity="false">
+        <appender-ref ref="audit"/>
+    </logger>
+
+</configuration>
diff --git a/openapi-meta/pom.xml b/openapi-meta/pom.xml
index 71503c09..cb6477b1 100644
--- a/openapi-meta/pom.xml
+++ b/openapi-meta/pom.xml
@@ -31,6 +31,10 @@
     </description>
 
     <dependencies>
+        <dependency>
+            <groupId>com.networknt</groupId>
+            <artifactId>openapi-helper</artifactId>
+        </dependency>
         <dependency>
             <groupId>com.networknt</groupId>
             <artifactId>utility</artifactId>
diff --git a/openapi-meta/src/main/java/com/networknt/openapi/parameter/ParameterDeserializer.java b/openapi-meta/src/main/java/com/networknt/openapi/parameter/ParameterDeserializer.java
index 39a29974..e0d90356 100644
--- a/openapi-meta/src/main/java/com/networknt/openapi/parameter/ParameterDeserializer.java
+++ b/openapi-meta/src/main/java/com/networknt/openapi/parameter/ParameterDeserializer.java
@@ -8,7 +8,6 @@
 
 import com.networknt.oas.model.Parameter;
 import com.networknt.openapi.OpenApiOperation;
-
 import io.undertow.server.HttpServerExchange;
 import io.undertow.util.AttachmentKey;
 
diff --git a/pom.xml b/pom.xml
index 65ce1a44..cd4e28c9 100644
--- a/pom.xml
+++ b/pom.xml
@@ -114,6 +114,7 @@
     </properties>
 
     <modules>
+        <module>openapi-helper</module>
         <module>openapi-meta</module>
         <module>openapi-validator</module>
         <module>openapi-security</module>
@@ -123,6 +124,11 @@
     <dependencyManagement>
         <dependencies>
             <!-- Modules in this project -->
+            <dependency>
+                <groupId>com.networknt</groupId>
+                <artifactId>openapi-helper</artifactId>
+                <version>${project.version}</version>
+            </dependency>
             <dependency>
                 <groupId>com.networknt</groupId>
                 <artifactId>openapi-meta</artifactId>