Author: davidb
Date: Fri May 1 14:28:31 2015
New Revision: 1677148
URL: http://svn.apache.org/r1677148
Log:
Put the text around OSGi R5 compliance back in as this went missing due to the
migration.
Modified:
felix/site/trunk/content/documentation/subprojects/apache-felix-osgi-bundle-repository.mdtext
Modified:
felix/site/trunk/content/documentation/subprojects/apache-felix-osgi-bundle-repository.mdtext
URL:
http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-osgi-bundle-repository.mdtext?rev=1677148&r1=1677147&r2=1677148&view=diff
==============================================================================
---
felix/site/trunk/content/documentation/subprojects/apache-felix-osgi-bundle-repository.mdtext
(original)
+++
felix/site/trunk/content/documentation/subprojects/apache-felix-osgi-bundle-repository.mdtext
Fri May 1 14:28:31 2015
@@ -22,6 +22,8 @@ Note: OBR provides access to the Felix'
## Overview
+As of release 2.0.x Felix OBR also supports the OSGi Repository 1.0
specification. Chapter 132 in the [OSGi R5 Enterprise specification][1]. A
client can look up the [OSGi Repository Service][2] in the service registry to
interact with Felix OBR in a specification compliant way.
+
For the most part, OBR is quite simple. An OBR "repository server" is not
necessary, since all functionality may reside on the client side. OBR is able
to provide its functionality by reading an XML-based meta-data file that
describes the bundles available to it. The meta-data file essentially contains
an XML encoding of the bundles' manifest information. From the meta-data, OBR
is able to construct dependency information for deploying (i.e., installing and
updating) bundles.
OBR defines the following entities:
@@ -36,6 +38,8 @@ OBR defines the following entities:
The following diagram illustrates the relationships among these entities:
+
+
!obr-entities.png!
The client has access to a federated set of repositories via the Repository
Admin service; such as depicted in this view:
@@ -46,7 +50,12 @@ The client has access to a federated set
## OBR Repository File
-The OBR repository file is an XML-based representation of bundle meta-data.
The goal is provide a generic model for describing dependencies among
resources; as such, the term **resource** is used instead of **bundle** in the
OBR repository syntax; a detailed description of the OBR meta-data format is
available in the [OSGi RFC
112](http://www2.osgi.org/download/rfc-0112_BundleRepository.pdf) document;
this document is not completely in sync with the implementation, but the
concepts are still correct. The following XML snippet depicts the overall
structure of a repository file:
+The OBR repository file is an XML-based representation of bundle meta-data.
The goal is provide a generic model for describing dependencies among
resources; as such, the term **resource** is used instead of **bundle** in the
OBR repository syntax. As of OBR release 2.0.2 two forms of metadata are
supported:
+
+* Repository XML as defined by the OSGi Repository Specification 1.0. Such an
XML file is in the http://www.osgi.org/xmlns/repository/v1.0.0 name space.
+* A Felix OBR-specific metadata format is also supported. This format predates
the format from the specification.
+
+A detailed description of the standard XML format is described in chapter 132
in the [OSGi R5 Enterprise specification][3]. The following XML snippet depicts
the overall structure of a repository file, using the proprietary Felix OBR
format:
<repository presentationname="..." symbolicname="..." ... >
@@ -312,3 +321,8 @@ In contrast to OSGi R4 the previous spec
## Feedback
Subscribe to the Felix users mailing list by sending a message to
[users-subscr...@felix.apache.org]({{
refs.mailto-users-subscribe-felix-apache-org.path }}); after subscribing, email
questions or feedback to [us...@felix.apache.org|mailto:us...@felix.apache.org].
+
+
+ [1]: http://www.osgi.org/Download/Release5
+ [2]:
http://www.osgi.org/javadoc/r5/enterprise/org/osgi/service/repository/package-summary.html
+ [3]: http://www.osgi.org/Download/Release5
\ No newline at end of file
