You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by dj...@apache.org on 2021/07/21 23:52:52 UTC
[felix-antora-site] branch main updated (9215ec9 -> d9197ee)
This is an automated email from the ASF dual-hosted git repository.
djencks pushed a change to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git.
from 9215ec9 remove when changeset again, it didn't help
new 50f54d5 fix framework page
new 7aabe3f fix broken links, compliance claim
new 1aa0e1c Just point to news page, without trying to show the few most recent
new 9c79a3f latest framework release is 7.0.1
new d9197ee fix framework distribution artifact names
The 5 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
modules/ROOT/examples/downloads.yml | 6 +++---
modules/ROOT/pages/downloads.adoc | 2 +-
modules/ROOT/pages/index.adoc | 5 +----
modules/ROOT/pages/subprojects/apache-felix-framework.adoc | 5 +++--
.../apache-felix-framework/apache-felix-framework-faq.adoc | 6 +++---
.../apache-felix-osgi-faq.adoc | 10 ++++++----
6 files changed, 17 insertions(+), 17 deletions(-)
[felix-antora-site] 01/05: fix framework page
Posted by dj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
djencks pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
commit 50f54d546aaa88b26458972c081dadda8da22e10
Author: David Jencks <dj...@apache.org>
AuthorDate: Wed Jul 21 16:09:35 2021 -0700
fix framework page
---
modules/ROOT/pages/subprojects/apache-felix-framework.adoc | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/modules/ROOT/pages/subprojects/apache-felix-framework.adoc b/modules/ROOT/pages/subprojects/apache-felix-framework.adoc
index 62c7527..a5ba2f3 100644
--- a/modules/ROOT/pages/subprojects/apache-felix-framework.adoc
+++ b/modules/ROOT/pages/subprojects/apache-felix-framework.adoc
@@ -1,7 +1,8 @@
= Apache Felix Framework
+:framework-version: R8
-The Felix Framework subproject is an implementation of the OSGi R6 core framework specification.
+The Felix Framework subproject is an implementation of the OSGi {framework-version} core framework specification.
== Framework documentation
-{% for label, page in children %}* link:{{ page.path }}[{{ page.headers.title }}] {% endfor %}
+indexList::[relative=subprojects/apache-felix-framework/*.adoc]
[felix-antora-site] 05/05: fix framework distribution artifact names
Posted by dj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
djencks pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
commit d9197ee5034f5809f0a23a901a2a901f1589174c
Author: David Jencks <dj...@apache.org>
AuthorDate: Wed Jul 21 16:51:00 2021 -0700
fix framework distribution artifact names
---
modules/ROOT/examples/downloads.yml | 2 +-
modules/ROOT/pages/downloads.adoc | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/modules/ROOT/examples/downloads.yml b/modules/ROOT/examples/downloads.yml
index bfc9de1..a20f696 100644
--- a/modules/ROOT/examples/downloads.yml
+++ b/modules/ROOT/examples/downloads.yml
@@ -14,7 +14,7 @@
# (1) Felix Framework Distribution version
framework:
- title: Framework
- artifactId: org.apache.felix.framework
+ artifactId: org.apache.felix.main.distribution
version: 7.0.1
changelog: framework/doc/changelog.txt
#
diff --git a/modules/ROOT/pages/downloads.adoc b/modules/ROOT/pages/downloads.adoc
index 86e2f97..0c015ba 100644
--- a/modules/ROOT/pages/downloads.adoc
+++ b/modules/ROOT/pages/downloads.adoc
@@ -18,7 +18,7 @@
|===
-jsonpathTable2::example$downloads.yml['$.framework.*', 'title|version|`{mirror}/$\{artifactId}-$\{version}.jar{query}[jar] ({dist}/$\{artifactId}-$\{version}.jar.asc[asc], {dist}/$\{artifactId}-$\{version}.jar.sha1[sha1])` |!!targz ? `{mirror}/$\{artifactId}-$\{version}-source-release.tar.gz{query}[tar.gz] ({dist}/$\{artifactId}-$\{version}-source-release.tar.gz.asc[asc], {dist}/$\{artifactId}-$\{version}-source-release.tar.gz.sha1[sha1])` : "" |`{mirror}/$\{artifactId}-$\{version}-sour [...]
+jsonpathTable2::example$downloads.yml['$.framework.*', 'title|version|`{mirror}/$\{artifactId}-$\{version}.zip{query}[zip] ({dist}/$\{artifactId}-$\{version}.jar.asc[asc], {dist}/$\{artifactId}-$\{version}.jar.sha1[sha1])` |!!targz ? `{mirror}/$\{artifactId}-$\{version}-source-release.tar.gz{query}[tar.gz] ({dist}/$\{artifactId}-$\{version}-source-release.tar.gz.asc[asc], {dist}/$\{artifactId}-$\{version}-source-release.tar.gz.sha1[sha1])` : "" |`{mirror}/$\{artifactId}-$\{version}-sour [...]
== Subprojects
[felix-antora-site] 03/05: Just point to news page,
without trying to show the few most recent
Posted by dj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
djencks pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
commit 1aa0e1c6b8b4ecda6917e356da2b574dad0653e7
Author: David Jencks <dj...@apache.org>
AuthorDate: Wed Jul 21 16:32:41 2021 -0700
Just point to news page, without trying to show the few most recent
---
modules/ROOT/pages/index.adoc | 5 +----
1 file changed, 1 insertion(+), 4 deletions(-)
diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc
index 96634a7..654819b 100644
--- a/modules/ROOT/pages/index.adoc
+++ b/modules/ROOT/pages/index.adoc
@@ -4,10 +4,7 @@ Apache Felix is a community effort to implement the http://www.osgi.org/Specific
The OSGi specifications originally targeted embedded devices and home services gateways, but they are ideally suited for any project interested in the principles of modularity, component-orientation, and/or service-orientation.
OSGi technology combines aspects of these aforementioned principles to define a dynamic service deployment framework that is amenable to remote management.
-== News
-
-A list of javascript extracted news excerpts:
-
+== List of releases by date
Refer to the news xref:news.adoc[archive] for all news.
[felix-antora-site] 02/05: fix broken links, compliance claim
Posted by dj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
djencks pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
commit 7aabe3f48d0dd4572973bfe14af3372ee8d43975
Author: David Jencks <dj...@apache.org>
AuthorDate: Wed Jul 21 16:24:02 2021 -0700
fix broken links, compliance claim
---
.../apache-felix-framework/apache-felix-framework-faq.adoc | 6 +++---
.../apache-felix-osgi-faq.adoc | 10 ++++++----
2 files changed, 9 insertions(+), 7 deletions(-)
diff --git a/modules/ROOT/pages/subprojects/apache-felix-framework/apache-felix-framework-faq.adoc b/modules/ROOT/pages/subprojects/apache-felix-framework/apache-felix-framework-faq.adoc
index e67e8e7..c818607 100644
--- a/modules/ROOT/pages/subprojects/apache-felix-framework/apache-felix-framework-faq.adoc
+++ b/modules/ROOT/pages/subprojects/apache-felix-framework/apache-felix-framework-faq.adoc
@@ -4,15 +4,15 @@
== Is the Felix framework compliant with the OSGi specification?
-Refer to the BROKEN_LINK xref:subprojects/apache-felix-framework/apache-felix-framework-osgi-r4-2-ct-results[Apache Felix Framework OSGi R4.2 CT Results] document.
+Yes.
== If I use bundles from Felix, will my application be tied to the Felix framework?
-See the answer in the BROKEN_LINK xref:subprojects/apache-felix-framework/apache-felix-osgi-faq-felix-dependencies.adoc[OSGi FAQ].
+See the answer in the xref:tutorials-examples-and-presentations/apache-felix-osgi-faq.adoc#subproject-independence[OSGi FAQ].
== When I update my bundle, why are my bundle's old classes still being used?
-See the answer in the BROKEN_LINK xref:subprojects/apache-felix-framework/apache-felix-osgi-faq-bundle-not-updated.adoc[OSGi FAQ].
+See the answer in the xref:tutorials-examples-and-presentations/apache-felix-osgi-faq.adoc#bundle-update-visibility[OSGi FAQ].
== Why do I get an "Unknown protocol: http" exception when I run Felix on a non-Sun JRE?
diff --git a/modules/ROOT/pages/tutorials-examples-and-presentations/apache-felix-osgi-faq.adoc b/modules/ROOT/pages/tutorials-examples-and-presentations/apache-felix-osgi-faq.adoc
index a5ef4d5..ab55993 100644
--- a/modules/ROOT/pages/tutorials-examples-and-presentations/apache-felix-osgi-faq.adoc
+++ b/modules/ROOT/pages/tutorials-examples-and-presentations/apache-felix-osgi-faq.adoc
@@ -1,7 +1,7 @@
= OSGi Frequently Asked Questions
-
+[#subproject-independence]
== If I use bundles from Felix, will my application be tied to the Felix framework?
No.
@@ -17,6 +17,7 @@ Additionally, due to specification ambiguity, it is possible the Felix framework
if in doubt, file a bug.
In the future, it is also possible some subprojects may require Felix, but they will explicitly state this fact.
+[#bundle-update-visibility]
== When I update my bundle, why are my bundle's old classes still being used?
Updating a bundle does not necessarily cause the new classes to be used immediately, it depends on two factors:
@@ -31,7 +32,7 @@ If no other bundles are using the exported packages, then the new classes will b
On the other hand, if any other bundles are using the exported packages, then the new classes will *not* become available immediately since the old version is still required by any dependent bundles.
In this case, the new classes will not be made available until `PackageAdmin.refreshPackages()` is called (this can be invoked in the Felix shell using the `refresh` command).
-There is one partial exception to this latter case, it occurs when the exporting bundle does *not* also import its own exported packages (see "<<should-a-bundle-import-its-own-exported-packages,Should a bundle import its own exported packages?>>" below for more information on this topic).
+There is one partial exception to this latter case, it occurs when the exporting bundle does *not* also import its own exported packages (see "<<import-own-exports,Should a bundle import its own exported packages?>>" below for more information on this topic).
In this case, the new classes become immediately accessible to the updated exporting bundle, but not to the dependent bundles;
the dependent bundles continue to see the old version of the classes.
This situation generally requires `PackageAdmin.refreshPackages()` to be invoked to bring the bundles back to a useful state.
@@ -44,13 +45,13 @@ This is done to reduce disruption when performing several updates.
There is no easy answer to this question and it largely depends on the specific usage scenario.
The OSGi specification had originally suggested that it was good practice to embed service API packages in the service provider bundle.
-In this case in OSGi R4, the service provider should both <<should-a-bundle-import-its-own-exported-packages,export and import>> the service API packages, which was the default for previous versions of the OSGi specification.
+In this case in OSGi R4, the service provider should both <<import-own-exports,export and import>> the service API packages, which was the default for previous versions of the OSGi specification.
The OSGi specification never had an explicit stance on whether or not a consumer bundle should embed its dependent service API packages;
although, it would not appear to be a best practice.
Logically, there is some sense to this approach, since it potentially allows the consumer bundle to gracefully handle broken service dependencies.
Of course, this depends on whether there is anything the bundle can do in the face of broken dependencies.
-If service API packages are embedded in the consumer bundle, then it should <<should-a-bundle-import-its-own-exported-packages,export and import>> the packages.
+If service API packages are embedded in the consumer bundle, then it should <<import-own-exports,export and import>> the packages.
An alternative approach in this case is to dynamically import the service API (or even use optional imports if the dependency should only be considered once).
The main advantages of embedding service API packages in bundles are that the dependencies can always be resolved and it does not require installing a lot of other bundles to resolve the dependencies.
@@ -66,6 +67,7 @@ This situation would be different if the service API were package in a separate
In this situation, all consumer bundles would be wired to the API bundle, not to the provider bundle.
Thus, if the provider were updated or uninstalled and then refreshed, the consumer bundles would only be minimally impacted (i.e., they would either switch to the new version of the provider or to a different provider).
+[#import-own-exports]
== Should a bundle import its own exported packages?
In OSGi R3 this was always the case, since Export-Package implied Import-Package.
[felix-antora-site] 04/05: latest framework release is 7.0.1
Posted by dj...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
djencks pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
commit 9c79a3f474b6e0233e5638aa5cd527eb6da05a53
Author: David Jencks <dj...@apache.org>
AuthorDate: Wed Jul 21 16:44:13 2021 -0700
latest framework release is 7.0.1
---
modules/ROOT/examples/downloads.yml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/modules/ROOT/examples/downloads.yml b/modules/ROOT/examples/downloads.yml
index 7722eb8..bfc9de1 100644
--- a/modules/ROOT/examples/downloads.yml
+++ b/modules/ROOT/examples/downloads.yml
@@ -15,7 +15,7 @@
framework:
- title: Framework
artifactId: org.apache.felix.framework
- version: 7.0.0
+ version: 7.0.1
changelog: framework/doc/changelog.txt
#
# (2) Subprojects
@@ -99,7 +99,7 @@ subprojects:
- title: Framework
artifactId: org.apache.felix.framework
- version: 7.0.0
+ version: 7.0.1
changelog: framework/doc/changelog.txt
- title: Framework Security