PHP Класс Raml\ApiDefinition

См. также: http://raml.org/spec.html
Наследование: implements raml\ArrayInstantiationInterface
Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод Описание
__construct ( string $title ) Create a new API Definition
addBaseUriParameter ( raml\NamedParameter $namedParameter ) Add a new base uri parameter
addDocumentation ( string $title, string $documentation ) Add a piece of documentation to the documentation list
addProtocol ( string $protocol ) Add a supported protocol
addResource ( raml\Resource $resource ) Add an additional resource
addSchemaCollection ( string $collectionName, array $schemas ) Add an schema
addSecuredBy ( raml\SecurityScheme $securityScheme ) Add an additional security scheme to the list of schemes the whole API is secured by
addSecurityScheme ( raml\SecurityScheme $securityScheme ) Add an additional security scheme
createFromArray ( string $title, array $data = [] ) : ApiDefinition Create a new API Definition from an array
getBaseUriParameters ( ) : raml\NamedParameter[] Get the base uri parameters
getBaseUrl ( ) : string Get the base URI
getDefaultMediaType ( ) : string Get the default media type
getDocumentationList ( ) : array Get the documentation of the API
getProtocols ( ) : array Get the list of support protocols
getResourceByPath ( string $path ) : Raml\Resource Get a resource by a path
getResourceByUri ( string $uri ) : Raml\Resource Get a resource by a uri
getResources ( ) : Raml\Resource[] Get the resources tree
getResourcesAsUri ( Raml\RouteFormatter\RouteFormatterInterface $formatter = null ) : Raml\RouteFormatter\RouteFormatterInterface Returns all the resources as a URI, essentially documenting the entire API Definition.
getSchemaCollections ( ) : array[] Get the schemas defined in the root of the API
getSecuredBy ( ) : raml\SecurityScheme Get a list of security schemes that the whole API is secured by
getSecurityScheme ( $schemeName ) : raml\SecurityScheme Get a security scheme by it's name
getTitle ( ) : string Get the title of the API
getVersion ( ) : string Get the version string of the API
setBaseUrl ( string $baseUrl ) Set the base url
setDefaultMediaType ( $defaultMediaType ) Set a default media type
setVersion ( $version ) Set the version
supportsHttp ( ) : boolean Does the API support HTTP (non SSL) requests?
supportsHttps ( ) : boolean Does the API support HTTPS (SSL enabled) requests?

Приватные методы

Метод Описание
addSchema ( string $collectionName, string $schemaName, string | Raml\Schema\SchemaDefinitionInterface $schema ) Add a new schema to a collection
getMethodsAsArray ( array $resources ) : array[BasicRoute] Recursive function that generates a flat array of the entire API Definition
getResourcesAsArray ( $resources ) : raml\Resource[]

Описание методов

__construct() публичный Метод

Create a new API Definition
public __construct ( string $title )
$title string

addBaseUriParameter() публичный Метод

Add a new base uri parameter
public addBaseUriParameter ( raml\NamedParameter $namedParameter )
$namedParameter raml\NamedParameter

addDocumentation() публичный Метод

Add a piece of documentation to the documentation list
public addDocumentation ( string $title, string $documentation )
$title string
$documentation string

addProtocol() публичный Метод

Add a supported protocol
public addProtocol ( string $protocol )
$protocol string

addResource() публичный Метод

Add an additional resource
public addResource ( raml\Resource $resource )
$resource raml\Resource

addSchemaCollection() публичный Метод

Add an schema
public addSchemaCollection ( string $collectionName, array $schemas )
$collectionName string
$schemas array

addSecuredBy() публичный Метод

Add an additional security scheme to the list of schemes the whole API is secured by
public addSecuredBy ( raml\SecurityScheme $securityScheme )
$securityScheme raml\SecurityScheme

addSecurityScheme() публичный Метод

Add an additional security scheme
public addSecurityScheme ( raml\SecurityScheme $securityScheme )
$securityScheme raml\SecurityScheme

createFromArray() публичный статический Метод

Create a new API Definition from an array
public static createFromArray ( string $title, array $data = [] ) : ApiDefinition
$title string
$data array [ title: string version: ?string baseUrl: ?string baseUriParameters: ?array protocols: ?array defaultMediaType: ?string schemas: ?array securitySchemes: ?array documentation: ?array /* ]
Результат ApiDefinition

getBaseUriParameters() публичный Метод

Get the base uri parameters
public getBaseUriParameters ( ) : raml\NamedParameter[]
Результат raml\NamedParameter[]

getBaseUrl() публичный Метод

Get the base URI
public getBaseUrl ( ) : string
Результат string

getDefaultMediaType() публичный Метод

Get the default media type
public getDefaultMediaType ( ) : string
Результат string

getDocumentationList() публичный Метод

Get the documentation of the API
public getDocumentationList ( ) : array
Результат array

getProtocols() публичный Метод

Get the list of support protocols
public getProtocols ( ) : array
Результат array

getResourceByPath() публичный Метод

Get a resource by a path
public getResourceByPath ( string $path ) : Raml\Resource
$path string
Результат Raml\Resource

getResourceByUri() публичный Метод

Get a resource by a uri
public getResourceByUri ( string $uri ) : Raml\Resource
$uri string
Результат Raml\Resource

getResources() публичный Метод

Get the resources tree
public getResources ( ) : Raml\Resource[]
Результат Raml\Resource[]

getResourcesAsUri() публичный Метод

This will output, by default, an array that looks like: GET /songs => [/songs, GET, Raml\Method] GET /songs/{songId} => [/songs/{songId}, GET, Raml\Method]
public getResourcesAsUri ( Raml\RouteFormatter\RouteFormatterInterface $formatter = null ) : Raml\RouteFormatter\RouteFormatterInterface
$formatter Raml\RouteFormatter\RouteFormatterInterface
Результат Raml\RouteFormatter\RouteFormatterInterface

getSchemaCollections() публичный Метод

Get the schemas defined in the root of the API
public getSchemaCollections ( ) : array[]
Результат array[]

getSecuredBy() публичный Метод

Get a list of security schemes that the whole API is secured by
public getSecuredBy ( ) : raml\SecurityScheme
Результат raml\SecurityScheme

getSecurityScheme() публичный Метод

Get a security scheme by it's name
public getSecurityScheme ( $schemeName ) : raml\SecurityScheme
$schemeName
Результат raml\SecurityScheme

getTitle() публичный Метод

Get the title of the API
public getTitle ( ) : string
Результат string

getVersion() публичный Метод

Get the version string of the API
public getVersion ( ) : string
Результат string

setBaseUrl() публичный Метод

Set the base url
public setBaseUrl ( string $baseUrl )
$baseUrl string

setDefaultMediaType() публичный Метод

Set a default media type
public setDefaultMediaType ( $defaultMediaType )
$defaultMediaType

setVersion() публичный Метод

Set the version
public setVersion ( $version )
$version

supportsHttp() публичный Метод

Does the API support HTTP (non SSL) requests?
public supportsHttp ( ) : boolean
Результат boolean

supportsHttps() публичный Метод

Does the API support HTTPS (SSL enabled) requests?
public supportsHttps ( ) : boolean
Результат boolean