new Stack(platform [, Object])
Parameters:
Name | Type | Argument | Description |
---|---|---|---|
platform |
Gitana.Platform | ||
Object |
<optional> |
object json object (if no callback required for populating) |
- Source:
Extends
Members
-
attach
-
Creates an attachment.
When using this method from within the JS driver, it really only works for text-based content such
as JSON or text.- Source:
-
getPreviewUri
-
Generates a URI to a preview resource.
- Source:
-
listAttachments
-
Hands back an attachments map.
- Source:
-
unattach
-
Deletes an attachment.
- Source:
Methods
-
__copyState()
-
Override the Chain.__copyState method so that it utilizes a base method that we can override
on a per-class basis.- Inherited From:
- Source:
-
assignDataStore(datastore, key)
-
Assigns a data store to the stack
It takes datastore and key (optional) as input or a json object than contains
datastore type, id and key (optional)Parameters:
Name Type Description datastore
Gitana.DataStore a platform datastore
key
String optional key
- Source:
-
attachment(attachmentId)
-
Picks off a single attachment
Parameters:
Name Type Description attachmentId
- Source:
-
chainCopyState(otherObject)
-
Override to include:
__system
Parameters:
Name Type Description otherObject
- Inherited From:
- Source:
-
chainCreate(chainable, object, uri, params)
-
Creates an object on the server (write + read).
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
object
uri
params
- Inherited From:
- Source:
-
chainCreateEx(chainable, object, createUri, readUri)
-
Creates an object on the server using one URL and then reads it back using another URL.
This exists because the security responses don't include _doc fields like other responses.Proceeds with the chain as bound to the chainable.
Parameters:
Name Type Description chainable
object
createUri
readUri
- Inherited From:
- Source:
-
chainDelete(chainable, uri, params)
-
Executes an HTTP delete for this object and continues the chain with the chainable.
Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainGet(chainable, uri, params)
-
Performs a GET from the server and populates the chainable.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainGetResponse(chainable, uri, params)
-
Performs a GET to the server and pushes the response into the chain.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainGetResponseRows(chainable, uri, params)
-
Performs a GET to the server and pushes the "rows" response attribute into the chain.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainGetResponseText(chainable, uri, params)
-
Performs a GET to the server and pushes the text response to the callback.
Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainHasResponseRow(chainable, uri, value)
-
Performs a GET to the server and checks whether the "rows" array attribute of the response
has the given value.Proceeds with the chain as bound to the chainable.
Parameters:
Name Type Description chainable
uri
value
- Inherited From:
- Source:
-
chainPatch(chainable, uri, params, payload)
-
Performs a PATCH to the server and populates the chainable with results.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
payload
- Inherited From:
- Source:
-
chainPost(chainable, uri, params, payload, handleFn)
-
Performs a POST to the server and populates the chainable with results.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
payload
handleFn
- Inherited From:
- Source:
-
chainPostEmpty(chainable, uri, params, payload, contentType)
-
Performs a POST to the server. The response is not handled.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
payload
(optional)
contentType
(optional) - example "text/plain"
- Inherited From:
- Source:
-
chainPostResponse(chainable, uri, params)
-
Performs a POST to the server and pushes the response into the chain.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainReload(uri, params)
-
Reloads this object from the server and then passes control to the chainable.
Parameters:
Name Type Description uri
params
- Inherited From:
- Source:
-
chainUpdate(chainable, uri, params)
-
Executes an update (write + read) of this object and then passes control to the chainable.
Parameters:
Name Type Description chainable
uri
params
- Inherited From:
- Source:
-
chainUpload(chainable, uri, params, contentType, payload)
-
Performs a POST to the server. The response is not handled.
Proceeds with the chain as bound to the chainable.Parameters:
Name Type Description chainable
uri
params
contentType
(optional) - example "text/plain"
payload
(optional)
- Inherited From:
- Source:
-
checkAuthority(principal, authorityId, callback)
-
Checks whether the given principal has a granted authority for this object.
This passes the result (true/false) to the chaining function.Parameters:
Name Type Description principal
Gitana.DomainPrincipal | String the principal or the principal id
authorityId
String the id of the authority
callback
- Inherited From:
- Source:
-
checkPermission(principal, permissionId, callback)
-
Checks whether the given principal has a permission against this object.
This passes the result (true/false) to the chaining function.Parameters:
Name Type Description principal
Gitana.DomainPrincipal | String the principal or the principal id
permissionId
String the id of the permission
callback
- Inherited From:
- Source:
-
clone()
-
- Source:
-
copy(target, asynchronous, config)
-
Copies this object into the target.
Parameters:
Name Type Description target
asynchronous
config
- Inherited From:
- Source:
-
createRole(roleKey, object)
-
Creates a role.
Parameters:
Name Type Description roleKey
object
- Source:
-
createTeam(teamKey, object)
-
Creates a team.
Parameters:
Name Type Description teamKey
object
- Source:
-
del()
-
Delete
- Inherited From:
- Source:
-
existsDataStore(key, callback)
-
Checks whether a datastore exists for the given key on this stack.
This passes the result (true/false) to the chaining function.Parameters:
Name Type Description key
String the datastore key
callback
function - Source:
-
exportArchive(settings)
-
Exports an archive.
Parameters:
Name Type Description settings
Object - Inherited From:
- Source:
-
extractPrincipalDomainQualifiedId(principal)
-
Helper to gets the principal id for a principal object, json structure or principal id itself.
This returns something like "domainId/principalId"Parameters:
Name Type Description principal
- Inherited From:
- Source:
-
extractPrincipalIdentifiers(principal, defaultDomainId)
-
Helper to gets the principal id for a principal object, json structure or principal id itself.
This returns something like "domainId/principalId"Parameters:
Name Type Description principal
principal object or string (principal id or domain qualified principal id)
defaultDomainId
- Inherited From:
- Source:
-
get(key)
-
Get a json property
Parameters:
Name Type Description key
- Inherited From:
- Source:
-
getDescription()
-
The description for the object.
- Inherited From:
- Source:
Returns:
the description
- Type
- String
-
getId()
-
Hands back the ID ("_doc") of this object.
- Inherited From:
- Source:
Returns:
id
- Type
- String
-
getProxiedUri()
-
Hands back the URI of this object as referenced by the browser.
- Inherited From:
- Source:
-
getSystemMetadata()
-
Hands back the system metadata for this object.
- Inherited From:
- Source:
Returns:
system metadata
-
getTitle()
-
The title for the object.
- Inherited From:
- Source:
Returns:
the title
- Type
- String
-
getType()
-
- Inherited From:
- Overrides:
- Source:
-
getUri()
-
- Inherited From:
- Overrides:
- Source:
-
grantAuthority(principal, authorityId)
-
Grants an authority to a principal against this object.
Parameters:
Name Type Description principal
Gitana.DomainPrincipal | String the principal or the principal id
authorityId
String the id of the authority
- Inherited From:
- Source:
-
handleResponse(response)
-
Parameters:
Name Type Description response
- Inherited From:
- Source:
-
handleSystemProperties()
-
Gets called after the response is handled and allows the object to pull out special values from
the "object" field so that they don't sit on the JSON object- Inherited From:
- Source:
-
importArchive(settings [, Function])
-
Imports an archive.
Parameters:
Name Type Argument Description settings
Object Function
<optional>
reportFn
- Inherited From:
- Source:
-
json()
-
Hands back a cleanup, properties-only JSON simple object.
- Inherited From:
- Source:
-
listAuthorities(principal, callback)
-
Retrieve list of authorities and pass into chaining method.
Parameters:
Name Type Description principal
Gitana.DomainPrincipal | String the principal or the principal id
callback
- Inherited From:
- Source:
-
listDataStores(pagination)
-
Lists the data stores in this stack.
Parameters:
Name Type Description pagination
- Source:
-
listRoles(inherited)
-
Lists roles.
Parameters:
Name Type Description inherited
whether to draw from inherited role containers
- Source:
-
listTeams()
-
Lists teams.
- Source:
-
loadACL(callback)
-
Retrieve full ACL and pass into chaining method.
Parameters:
Name Type Description callback
- Inherited From:
- Source:
-
loadAuthorityGrants(callback)
-
Loads the authority grants for a given set of principals.
Parameters:
Name Type Description callback
- Inherited From:
- Source:
-
loadFrom(anotherObject)
-
Helper method that loads this object from another object of the same type.
For example, loading a node from another loaded node.
Parameters:
Name Type Description anotherObject
- Inherited From:
- Source:
-
queryDataStores(query [, Object])
-
Lists the data stores in this stack.
Parameters:
Name Type Argument Description query
Object Object
<optional>
pagination pagination (optional)
- Source:
-
queryLogEntries(query [, Object])
-
Queries for log entries.
Parameters:
Name Type Argument Description query
Object Query for finding log entries.
Object
<optional>
pagination pagination (optional)
- Source:
-
readDataStore(key [, callback])
-
Reads a data store for this stack by its key.
Parameters:
Name Type Argument Description key
String the datastore key
callback
<optional>
a callback receiver to grab the actual typed object once retrieved
- Source:
-
readLog(callback)
-
Reads the last 100 lines of the log as text.
The callback receives the text as the argument.Parameters:
Name Type Description callback
- Source:
-
readLogEntry(jobId)
-
Read a log entry.
Parameters:
Name Type Description jobId
String - Source:
-
readOwnersTeam()
-
Gets the owners team
- Source:
-
readRole(roleKeyOrId, inherited)
-
Reads a role.
Parameters:
Name Type Description roleKeyOrId
inherited
whether to check inherited role containers
- Source:
-
readTeam(teamKey)
-
Reads a team.
Parameters:
Name Type Description teamKey
- Source:
-
ref()
-
- Inherited From:
- Source:
Returns:
a string denoting a reference to this object.
- Type
- String
-
reload()
-
Reload
- Inherited From:
- Source:
-
replacePropertiesWith(object)
-
Replaces all of the properties of this object with those of the given object.
This method should be used to update the state of this object.Any functions from the incoming object will not be copied.
Parameters:
Name Type Description object
Object object containing the properties
- Inherited From:
- Source:
-
revokeAllAuthorities(principal)
-
Revokes all authorities for a principal against the server.
Parameters:
Name Type Description principal
Gitana.Principal | String the principal or the principal id
- Inherited From:
- Source:
-
revokeAuthority(principal, authorityId)
-
Revokes an authority from a principal against this object.
Parameters:
Name Type Description principal
Gitana.DomainPrincipal | String the principal or the principal id
authorityId
String the id of the authority
- Inherited From:
- Source:
-
set(key, value)
-
Set a json property
Parameters:
Name Type Description key
value
- Inherited From:
- Source:
-
stringify(pretty)
-
Helper function to convert the object portion to JSON
Parameters:
Name Type Description pretty
- Inherited From:
- Source:
-
unassignDataStore(key)
-
Unassigns a data store from the stack
Parameters:
Name Type Description key
String optional key
- Source:
-
update()
-
Update
- Inherited From:
- Source: