---
name: "POEx::Role::SessionInstantiation::Meta::Session::Events"
section: "3pm"
platform: "linux"
package: "libpoex-role-sessioninstantiation-perl"
version: "1.101040-1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/POEx::Role::SessionInstantiation::Meta::Session::Events"
---

# POEx::Role::SessionInstantiation::Meta::Session::Events(3pm)

Provides default events such as \_start, \_stop, etc

## NAME

POEx::Role::SessionInstantiation::Meta::Session::Events - Provides default events such as \_start, \_stop, etc

## VERSION

version 1.101040

## PRIVATE\_METHODS

### \_start

```
    is Event
```

Provides a default \_start event handler that will be invoked from POE once the Session is registered with POE. The default method only takes the alias  attribute and sets it again to activate the trigger. If this is overridden,  don't forget to set the alias again so the trigger can execute.

### *\_stop()*

```
    is Event
```

Provides a default \_stop event handler that will be invoked from POE once the  Session's refcount from within POE has reached zero (no pending events, no event sources, etc). The default method merely clears out the alias.

### \_default

```
    (Maybe[ArrayRef] $args) is Event
```

Provides a \_default event handler to catch any POE event invocations that your instance does not actually have. Will 'warn' about the nonexistent state. A big difference from POE::Session is that the state and arguments are not rebundled  upon invocation of this event handler. Instead the attempted state will be available in the poe attribute, but the arguments are still bundled into a  single ArrayRef

### \_child

```
    (Str $event, Session|DoesSessionInstantiation $child, Any $ret) is Event
```

Provides a \_child event handler that will be invoked when child sesssions are created, destroyed or reassigned to or from another parent. See POE::Kernel for more details on this event and its semantics

### \_parent

```
    Session|DoesSessionInstantiation|Kernel $previous_parent, Session|DoesSessionInstantiation|Kernel $new_parent) is Event
```

Provides a \_parent event handler. This is used to notify children session when their parent has changes. See POE::Kernel for more details on this event.

## AUTHOR

```
  Nicholas Perez <nperez@cpan.org>
```

## COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Nicholas Perez.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.