http://www.osgi.org/xmlns/blueprint/v1.0.0
element reference

Model

<reference
  activation = "eager" | "lazy"
  availability = "mandatory" | "optional"
  component-name = Tidref
  depends-on = list of at least 1 of (Tidref)
  filter = normalizedString
  id = ID
  interface = Tclass
  timeout = Ttimeout
  (any attribute from any namespace other than http://www.osgi.org/xmlns/blueprint/v1.0.0)>
description?, reference-listener*, (any element from any namespace other than http://www.osgi.org/xmlns/blueprint/v1.0.0)
</reference>

Disallowed substitutions (block)

none (extensions, restrictions and substitutions are allowed)

Substitution group exclusion (final)

none (extensions and restrictions are allowed)

Content Type

declared with type Treference
element-only content, not nillable.

Usage

This element can be the child of element Tblueprint/type-converters.

Scope

local declared in complex type Ttype-converters

activation

Documentation

                    
                    The activation attribute for this component.  This can either
                    be "eager" or "lazy".  If not specified, it
                    defaults to default-activation attribute of the enclosing
                    <blueprint> element.
                    
				

Definition

Defined with global type Tactivation

Model

"eager" | "lazy"

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

availability

Documentation

                            
                            Use to control the initial processing of service references at
                            blueprint context startup.  "mandatory" indicates the context
                            should not start unless the service is available within the
                            specified context startup period.  "optional" indicates availability
                            of this service is not a requirement at bundle startup.

                            NOTE:  No default is specified because this can be overridden
                            by the default-availability attribute of the <blueprint> element.
                            
						

Definition

Defined with global type Tavailability

Model

"mandatory" | "optional"

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

component-name

Documentation

                            
                            An optional specifier that can be used to match a service definition
                            to one created by a specific blueprint component.
                            
						

Definition

Defined with global type Tidref

Model

{NCName: pattern = \i\c*}

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

depends-on

Documentation

                    
                    depends-on identifies (by id) other components that this component
                    depends on.  The component only be activated after the
                    depends-on components are successfully activated.  Also, if there
                    are <reference> or <reference-list> elements with unstatisfied
                    manadatory references, then the depends-on relationship will also
                    be used to determine whether this service is enabled or not.
                    
				

Definition

Defined with global type TdependsOn

Model

list of at least 1 of ({: pattern = \i\c*})

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

Type

TdependsOn

filter

Documentation

                            
                            A filter string used to narrow the search for a matching service
                            reference.
                            
						

Definition

Defined with global type normalizedString

Model

normalizedString

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

id

Definition

Defined with global type ID

Model

ID

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

interface

Documentation

                            
                            The interface that the OSGi service must implement and that will be
                            implemented by the proxy object.
                            This attribute is optional.
                            
						

Definition

Defined with global type Tclass

Model

{NCName: pattern = \i\c*}

Attribute Usage

optional

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

White Space Processing

collapse

timeout

Definition

Defined with global type Ttimeout

Model

{unsignedLong: 0 ≤ value ≤ 18446744073709551615}

Attribute Usage

optional

Fundamental Facets

equality, numeric, bounded, totaly ordered, countable infinite value space

White Space Processing

collapse