* User: Tony Field Date: 2011-05-06
*
- * @deprecated May 15, 2016 by fvillalba
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
*
*/
@Deprecated
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/vwebroot/VirtualWebrootDao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/vwebroot/VirtualWebrootDao.java
index b40dc43b..c419fef7 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/vwebroot/VirtualWebrootDao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/vwebroot/VirtualWebrootDao.java
@@ -26,7 +26,7 @@
* @author Dolf Dijkstra
*
*
- * @deprecated May 15, 2016 by fvillalba
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
*
*/
@Deprecated
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/Alias.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/Alias.java
index e650f1f5..5042d87c 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/Alias.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/Alias.java
@@ -22,6 +22,10 @@
*
* @author Larissa Kowaliw
* @since Jul 27, 2010
+ *
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation which won't depend on any GSF-specific asset type / subtypes.
+ *
*/
public interface Alias extends WebReferenceableAsset {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasBeanImpl.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasBeanImpl.java
index 7983a41a..e1928c04 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasBeanImpl.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasBeanImpl.java
@@ -22,6 +22,9 @@
*
* @author Larissa Kowaliw
* @since Jul 27, 2010
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation which won't depend on any GSF-specific asset type / subtypes.
+ *
*/
public class AliasBeanImpl extends WraBeanImpl implements Alias {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasCoreFieldDao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasCoreFieldDao.java
index 5f3faca9..53e49928 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasCoreFieldDao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AliasCoreFieldDao.java
@@ -24,6 +24,9 @@
*
* @author Tony Field
* @since Jul 21, 2010
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation which won't depend on any GSF-specific asset type / subtypes.
+ *
*/
public interface AliasCoreFieldDao {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiAliasCoreFieldDao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiAliasCoreFieldDao.java
index 94db898c..35062be0 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiAliasCoreFieldDao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiAliasCoreFieldDao.java
@@ -42,6 +42,9 @@
*
* @author Tony Field
* @since Jul 21, 2010
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public class AssetApiAliasCoreFieldDao implements AliasCoreFieldDao {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiWraCoreFieldDao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiWraCoreFieldDao.java
index dd8c376c..f7f6542b 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiWraCoreFieldDao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/AssetApiWraCoreFieldDao.java
@@ -43,6 +43,9 @@
*
* @author Tony Field
* @since Jul 21, 2010
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public class AssetApiWraCoreFieldDao implements WraCoreFieldDao {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWRADao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWRADao.java
index 87078919..d85eef44 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWRADao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWRADao.java
@@ -20,6 +20,8 @@
/**
* @author Dolf Dijkstra
*
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public interface SimpleWRADao {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWra.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWra.java
index 653fb4f3..fa7abfdc 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWra.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/SimpleWra.java
@@ -23,6 +23,9 @@
/**
* @author Dolf Dijkstra
*
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public class SimpleWra {
private final Row row;
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAsset.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAsset.java
index d4c98328..b201bd15 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAsset.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAsset.java
@@ -25,6 +25,9 @@
* @author Dolf Dijkstra
* @since 10 mei 2012
*
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public interface VanityAsset {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAssetBean.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAssetBean.java
index c7c72b5a..f205bcaf 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAssetBean.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/VanityAssetBean.java
@@ -24,6 +24,9 @@
*
* @author Dolf Dijkstra
*
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public class VanityAssetBean implements VanityAsset {
private AssetId id;
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WebReferenceableAsset.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WebReferenceableAsset.java
index bdc5c5b1..9ab45ec3 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WebReferenceableAsset.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WebReferenceableAsset.java
@@ -22,6 +22,9 @@
* @author Tony Field
* @author Dolf Dijkstra
* @since Jul 21, 2010
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public interface WebReferenceableAsset extends VanityAsset {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraBeanImpl.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraBeanImpl.java
index a5f31843..b4a3edaa 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraBeanImpl.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraBeanImpl.java
@@ -25,6 +25,10 @@
*
* @author Tony Field
* @since Jul 21, 2010
+ *
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public class WraBeanImpl implements WebReferenceableAsset {
private AssetId id;
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldApiBypassDao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldApiBypassDao.java
index c9f49665..f2e94d48 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldApiBypassDao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldApiBypassDao.java
@@ -44,6 +44,10 @@
* User: Tony Field Date: 2011-05-06
*
* @author Dolf Dijkstra
+ *
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public class WraCoreFieldApiBypassDao extends AssetApiWraCoreFieldDao {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldDao.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldDao.java
index f5013369..bb33ecd6 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldDao.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraCoreFieldDao.java
@@ -26,6 +26,10 @@
* @author Tony Field
* @author Dolf Dijkstra
* @since Jul 21, 2010
+ *
+ *
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
+ *
*/
public interface WraCoreFieldDao {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraUriBuilder.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraUriBuilder.java
index c3afabb7..a6f9e6c5 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraUriBuilder.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/WraUriBuilder.java
@@ -28,7 +28,7 @@
* @author Dolf Dijkstra
* @since Mar 13, 2011
*
- * @deprecated fvillalba on June 16, 2016
+ * @deprecated as of release 12.x, replace with WCS 12c's native vanity URLs support.
*/
@Deprecated
public class WraUriBuilder {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/AbstractNavigationHelper.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/AbstractNavigationHelper.java
index 127500a7..080a0d3a 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/AbstractNavigationHelper.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/AbstractNavigationHelper.java
@@ -43,6 +43,9 @@
*
* @author Dolf Dijkstra
* @deprecated replaced with {@link NavigationService}
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation (coming soon)
+ *
*/
public abstract class AbstractNavigationHelper {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavNode.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavNode.java
index 60439ea4..3fb12c01 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavNode.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavNode.java
@@ -28,6 +28,9 @@
*
* @author Dolf Dijkstra
* @since Feb 8, 2011
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation (coming soon)
+ *
*/
@Deprecated
public class NavNode {
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper.java
index 00755ca0..c561c228 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper.java
@@ -60,7 +60,7 @@
* @author Dolf Dijkstra
* @since Jun 17, 2010
*
- * @deprecated June 16, 2016 by fvillalba
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation (coming soon)
*
*/
@Deprecated
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper2.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper2.java
index 48247fb1..9edfb806 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper2.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/NavigationHelper2.java
@@ -54,7 +54,8 @@
*
* @author Dolf Dijkstra
* @since Jun 8, 2012
- * @deprecated replaced with {@link NavigationService}
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation (coming soon)
*/
public class NavigationHelper2 extends AbstractNavigationHelper {
/**
diff --git a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/WraNavigationService.java b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/WraNavigationService.java
index 0e6cfdd1..36e9b813 100644
--- a/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/WraNavigationService.java
+++ b/gsf-wra-legacy/src/main/java/com/fatwire/gst/foundation/wra/navigation/WraNavigationService.java
@@ -54,6 +54,9 @@
/**
* @author Dolf Dijkstra
*
+ *
+ * @deprecated as of release 12.x, will be replaced with a brand new, significantly improved NavigationService implementation (coming soon)
+ *
*/
public class WraNavigationService extends AbstractNavigationService implements NavigationService {
diff --git a/src/site/apt/InstallGuide.apt b/src/site/apt/InstallGuide.apt
index b61c0b4d..e1fc8422 100644
--- a/src/site/apt/InstallGuide.apt
+++ b/src/site/apt/InstallGuide.apt
@@ -16,7 +16,86 @@
Installation Guide
-WORK IN PROGRESS
+ This release of the GSF is transitional, meaning it is primarily aimed at users upgrading their WCS 11g implementations to WCS 12c.
+
+ Both brand new and re-engineered features specifically designed for WCS 12c will be released in the next major release of the GSF,
+ coming very soon (2016).
+
+ For this reason, we will outline 2 different installation procedures, both of them manual:
+
+ * A very simple one, for users upgrading from WCS 11g.
+
+ * A simple one, for users starting fresh with WCS 12c and GSF-12 who are not going to be using any of the deprecated features / classes.
+
+ * A complex one, for users wanting to use deprecated features shipped in GSF-12.
+
+ You are strongly advised not to use any of the DEPRECATED features in this release, which are packaged inside the "-legacy" JAR file.
+
+ Deprecated features will be eventually wiped out from the GSF codebase (and JAR files) in the upcoming releases. Hence, any application
+ whose code depends on such features / classes will eventually stop working properly.
+
+ In case you are already using deprecated features, you should reengineer any affected classes / components so to replace any dependencies
+ on deprecated features with the equivalent native feature(s) in WCS 12c.
+
+ UPGRADING FROM WCS / GSF 11g
+
+ Assuming you just want to reuse your existing code on 12c, you'd just need to:
+
+ - Replace the existing GSF JAR file with:
+ * The new "CORE" JAR file.
+ * In case you are using any deprecated features / classes, the "LEGACY" JAR file.
+
+ - In case you want to use the new AppContext loader (listener), you don't need to do anything; GSF-12 will default to it.
+
+ - In case you are using a custom AppContext loader:
+ * Configure the due listener as needed, inside WCS 12c's web.xml file.
+ * Make sure the required classes are deployed.
+ * Make sure it still works as expected in WCS 12c.
+
+ - If you are using GSF Actions or any other deprecated features / services which depend on DefaultWebAppContext and you want to
+ keep using them, then you must either:
+
+ * Use "LegacyDefaultWebAppContext" instead of "DefaultWebAppContext" by wiring it up explicitly inside WCS 12c's web.xml file.
+ For example:
+
+