Link

class Link(var parent: ParentResource, name: String) : AbstractParentResource, ResolvableResource

A reference to another resource (similar to symbolic links in *nix filesystems).

Suppose we have a game with monsters, let's suppose we have Roles "/monsters/big" and "/monsters/bad". Occasionally, they growl, so we put a sound in each called "growl" (e.g. "/monsters/big/growl"). Now suppose we create a new monster "/monsters/ugly". Its appearance is different, but its growl is the same as "bad's".. Instead of creating another copy, we create a Link (/monsters/ugly/growl) which points to "/monsters/bad/growl".

We will have a Behaviour for all monsters, which can find the appropriate sound like so :

val growl = actor.role!!.find( "growl" ) as Sound

I often use links. YMMV.

Constructors

Link

constructor(parent: ParentResource, name: String)

Properties

children

open override val children: MutableObservableMap<String, Resource>

linkedResource

var linkedResource: Resource?

linkToPath

var linkToPath: String

name

override var name: String

parent

override var parent: ParentResource

resourceType

open override val resourceType: ResourceType

Functions

add

open override fun add(child: Resource)

dangerousRename

open override fun dangerousRename(newName: String)

find

open fun find(path: String): Resource?

findAppearance

open fun findAppearance(path: String): AppearanceResource?

findChild

open override fun findChild(name: String): Resource?

findUnresolved

open fun findUnresolved(path: String): Resource?

game

override fun game(): Game

path

override fun path(): String

pathWithTrailingSlash

override fun pathWithTrailingSlash(): String

Similar to path, but it also includes a trailing path. This is useful when building descendant paths as there is no special case needed for the root Game.

remove

open override fun remove(child: Resource)

rename

open override fun rename(child: Resource, newName: String)

resolveReferences

open override fun resolveReferences(): String?

walkTree

open override fun walkTree(onVisit: (Resource) -> Unit)