Difference between revisions of "ProviderLifetimeEventsHandler"
From Virtual World Web Wiki
(Documentation for the ProviderLifetimeEventsHandler class) |
(Documentation for the ProviderLifetimeEventsHandler class) |
||
Line 1: | Line 1: | ||
+ | This class implements a Layer Two extensibility point as virtual members which can be overriden as needed. Derive from this class to provide your own implementation. | ||
+ | |||
+ | '''See also:''' [[IProviderLifetimeEvents]] | ||
+ | |||
+ | '''See also:''' [[IComponentEvents]] | ||
+ | |||
===Remarks <nowiki>[</nowiki>[{{fullurl:ProviderLifetimeEventsHandler Remarks|action=edit}} edit]<nowiki>]</nowiki>=== | ===Remarks <nowiki>[</nowiki>[{{fullurl:ProviderLifetimeEventsHandler Remarks|action=edit}} edit]<nowiki>]</nowiki>=== | ||
{{:ProviderLifetimeEventsHandler Remarks}} | {{:ProviderLifetimeEventsHandler Remarks}} | ||
Line 4: | Line 10: | ||
===Methods=== | ===Methods=== | ||
:{{CSharp|void AttachComponent(Guid rootWorldID)}} | :{{CSharp|void AttachComponent(Guid rootWorldID)}} | ||
+ | :: | ||
+ | ::Called when your component is installed on a root world | ||
:{{CSharp|void ComponentAttached(Guid componentID, Guid rootWorldID)}} | :{{CSharp|void ComponentAttached(Guid componentID, Guid rootWorldID)}} | ||
+ | :: | ||
+ | ::Called after a component is installed on a root world to notify other components of this fact | ||
:{{CSharp|void ComponentDetaching(Guid componentID, Guid rootWorldID)}} | :{{CSharp|void ComponentDetaching(Guid componentID, Guid rootWorldID)}} | ||
+ | :: | ||
+ | ::Called before a component is unsinstalled from a root world to notify other components of this fact | ||
:{{CSharp|void DetachComponent(Guid rootWorldID)}} | :{{CSharp|void DetachComponent(Guid rootWorldID)}} | ||
+ | :: | ||
+ | ::Called when your component is uninstalled from a root world | ||
:{{CSharp|void Initialize()}} | :{{CSharp|void Initialize()}} | ||
+ | :: | ||
+ | ::Fires when the service provider service starts up and initializes the Layer Two component system | ||
:{{CSharp|bool Install()}} | :{{CSharp|bool Install()}} | ||
+ | :: | ||
+ | ::Called once by the service provider on component install | ||
:{{CSharp|Byte[] PackSeedData(ITransferItem item)}} | :{{CSharp|Byte[] PackSeedData(ITransferItem item)}} | ||
+ | :: | ||
+ | ::Asks the component to package any seed data that should be delivered along with a component install or upgrade. Try to keep this less than a few MB if possible! | ||
:{{CSharp|void Shutdown()}} | :{{CSharp|void Shutdown()}} | ||
+ | :: | ||
+ | ::Fires when the service provider service is shutting down | ||
:{{CSharp|void SystemIntegrityCheckCompleted()}} | :{{CSharp|void SystemIntegrityCheckCompleted()}} | ||
+ | :: | ||
+ | ::Called by L1 after a system-wide layout validation and integrity check | ||
:{{CSharp|void SystemIntegrityCheckStarting()}} | :{{CSharp|void SystemIntegrityCheckStarting()}} | ||
+ | :: | ||
+ | ::Called by L1 before a system-wide layout validation and integrity check | ||
:{{CSharp|bool Uninstall()}} | :{{CSharp|bool Uninstall()}} | ||
+ | :: | ||
+ | ::Called once by the service provider on component uninstall | ||
:{{CSharp|void UnPackSeedData(Byte[] data)}} | :{{CSharp|void UnPackSeedData(Byte[] data)}} | ||
+ | :: | ||
+ | ::Asks the component to import seed data provided as part of an update or install. This will be the first method called on a component even before Install or Initialize | ||
:{{CSharp|bool Upgrade()}} | :{{CSharp|bool Upgrade()}} | ||
+ | :: | ||
+ | ::Called by the service provider when this component is being upgraded from a previous version | ||
__NOTOC____NOEDITSECTION__ | __NOTOC____NOEDITSECTION__ |
Revision as of 16:34, 21 October 2016
This class implements a Layer Two extensibility point as virtual members which can be overriden as needed. Derive from this class to provide your own implementation.
See also: IProviderLifetimeEvents
See also: IComponentEvents
Remarks [edit]
Methods
- void AttachComponent(Guid rootWorldID)
- Called when your component is installed on a root world
- void ComponentAttached(Guid componentID, Guid rootWorldID)
- Called after a component is installed on a root world to notify other components of this fact
- void ComponentDetaching(Guid componentID, Guid rootWorldID)
- Called before a component is unsinstalled from a root world to notify other components of this fact
- void DetachComponent(Guid rootWorldID)
- Called when your component is uninstalled from a root world
- void Initialize()
- Fires when the service provider service starts up and initializes the Layer Two component system
- bool Install()
- Called once by the service provider on component install
- Byte[] PackSeedData(ITransferItem item)
- Asks the component to package any seed data that should be delivered along with a component install or upgrade. Try to keep this less than a few MB if possible!
- void Shutdown()
- Fires when the service provider service is shutting down
- void SystemIntegrityCheckCompleted()
- Called by L1 after a system-wide layout validation and integrity check
- void SystemIntegrityCheckStarting()
- Called by L1 before a system-wide layout validation and integrity check
- bool Uninstall()
- Called once by the service provider on component uninstall
- void UnPackSeedData(Byte[] data)
- Asks the component to import seed data provided as part of an update or install. This will be the first method called on a component even before Install or Initialize
- bool Upgrade()
- Called by the service provider when this component is being upgraded from a previous version