inteligr8/alfresco-community-repo
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-community-repo.git synced 2025-07-24 17:32:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

Prettier exception when virt server is down.

Browse Source 
Optimization for initial validation (no rescan necessary on empty store).
Now emulating forgiving (non RFC-2396/3987 compliant) behavior most 
browsers exhibit on links like: <a href="mind the gap.html">...</a>
Also bumped schema version to deal with link canonicalization


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@6190 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
This commit is contained in:
Jon Cox
2007-07-08 04:03:06 +00:00
parent c5d97bfebe
commit cce11fa38b
2 changed files with 84 additions and 69 deletions
Download Patch File Download Diff File Expand all files Collapse all files

97
source/java/org/alfresco/linkvalidation/LinkValidationService.java
View File

@@ -1,16 +1,16 @@
/*-----------------------------------------------------------------------------
* Copyright 2007 Alfresco Inc.
*
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* for more details.
*
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. As a special
@@ -19,8 +19,8 @@
* Software ("FLOSS") applications as described in Alfresco's FLOSS exception.
* You should have received a copy of the text describing the FLOSS exception,
* and it is also available here: http://www.alfresco.com/legal/licensing
*
*
*
*
* Author Jon Cox <jcox@alfresco.com>
* File LinkValidationService.java
*----------------------------------------------------------------------------*/
@@ -41,7 +41,7 @@ public interface LinkValidationService
//-------------------------------------------------------------------------
/**
* This function is just a convenience wrapper for calling
* This function is just a convenience wrapper for calling
* getHrefManifestEntries with statusGTE=400 and statusLTE=599.
* <p>
* Note: Files and urls within this list of manifests pertain to
@@ -51,24 +51,26 @@ public interface LinkValidationService
* snapshot as new as possible, automatically.
*/
//-------------------------------------------------------------------------
public List<HrefManifestEntry> getBrokenHrefManifestEntries(
String storeNameOrWebappPath
) throws AVMNotFoundException;
public List<HrefManifestEntry> getBrokenHrefManifestEntries(
String storeNameOrWebappPath)
throws AVMNotFoundException,
SocketException;
//-------------------------------------------------------------------------
/**
* Returns a manifest consisting of just the broken hrefs
* within each file containing one or more broken href.
* The HrefManifestEntry list is sorted in increasing lexicographic
* Returns a manifest consisting of just the broken hrefs
* within each file containing one or more broken href.
* The HrefManifestEntry list is sorted in increasing lexicographic
* order by file name. The hrefs within each HrefManifestEntry
* are also sorted in increasing lexicographic order.
*/
//-------------------------------------------------------------------------
public List<HrefManifestEntry> getHrefManifestEntries(
String storeNameOrWebappPath,
int statusGTE,
int statusLTE) throws
AVMNotFoundException;
public List<HrefManifestEntry> getHrefManifestEntries(
String storeNameOrWebappPath,
int statusGTE,
int statusLTE)
throws AVMNotFoundException,
SocketException;
//-------------------------------------------------------------------------
@@ -80,9 +82,9 @@ public interface LinkValidationService
* snapshot, but it's async, so it might be older.
*/
//-------------------------------------------------------------------------
public HrefDifference getHrefDifference(
String srcWebappPath,
String dstWebappPath,
public HrefDifference getHrefDifference(
String srcWebappPath,
String dstWebappPath,
HrefValidationProgress progress)
throws AVMNotFoundException,
SocketException,
@@ -93,16 +95,16 @@ public interface LinkValidationService
//-------------------------------------------------------------------------
/**
* Fetches a manifest of all hyperlinks broken by files
* Fetches a manifest of all hyperlinks broken by files
* deleted in a HrefDifference. Files and hrefs in this
* manifest will be in the namespace of the src in the
* HrefDifference. For example, suppose the "test"
* web project had a ROOT webapp with a link within
* web project had a ROOT webapp with a link within
* "moo.html" that pointed to: "hamlet.html".
* Now suppose that user 'alice' proposes to delete "hamlet.html".
* Because 'alice' is the 'src' and staging is the 'dst'
* in the HrefDifference, all files and hyperlinks appear from
* the perspective of the main working store within
* the perspective of the main working store within
* alice's sandbox. Thus, the broken link info is as follows:
*
* <pre>
@@ -113,7 +115,7 @@ public interface LinkValidationService
* http://alice.test.www--sandbox.version--v-1.127-0-0-1.ip.alfrescodemo.net:8180/hamlet.html
* </pre>
*
* @param hdiff The difference between two webapps obtained
* @param hdiff The difference between two webapps obtained
* by calling getHrefDifference().
*/
//-------------------------------------------------------------------------
@@ -125,11 +127,11 @@ public interface LinkValidationService
//-------------------------------------------------------------------------
/**
* Fetches a manifest of all hyperlinks broken in new or modified files in
* an HrefDifference. Similar to getHrefManifestBrokenByDelete(),
* an HrefDifference. Similar to getHrefManifestBrokenByDelete(),
* the entries in this manifest are in the 'src' namespace of the
* HrefDifference operation (i.e.: files & urls from alice, not staging).
*
* @param hdiff The difference between two webapps obtained
* @param hdiff The difference between two webapps obtained
* by calling getHrefDifference().
*/
//-------------------------------------------------------------------------
@@ -140,48 +142,48 @@ public interface LinkValidationService
//-------------------------------------------------------------------------
/**
* WARNING: this function won't be part of the public interface for long.
* WARNING: this function won't be part of the public interface for long.
* Updates href status and href file dependencies for path.
*
* @param path
* @param path
* <ul>
* <li> If null, do all stores & all webapps in them.
* <li> If store, do all webapps in store
* <li> If webapp, do webapp.
* </ul>
*
* @param incremental
* If true, updates information incrementally, based on the
* files that have changed and prior calculations regarding
*
* @param incremental
* If true, updates information incrementally, based on the
* files that have changed and prior calculations regarding
* url-to-file dependencies. If false, first deletes all URL
* info associated with the store/webapp (if any), then does
* info associated with the store/webapp (if any), then does
* a full rescan to update info.
*
*
* @validateExternal
* Currently does nothing. Perhaps one day you'll be able to
* turn off validation of external links.
*
* @param progress
* While updateHrefInfo() is a synchronous function,
* 'status' may be polled in a separate thread to
* While updateHrefInfo() is a synchronous function,
* 'status' may be polled in a separate thread to
* observe its progress.
*/
//-------------------------------------------------------------------------
public void updateHrefInfo( String path,
boolean incremental,
boolean validateExternal,
HrefValidationProgress progress)
throws AVMNotFoundException,
SocketException,
SSLException,
LinkValidationAbortedException;
public void updateHrefInfo( String path,
boolean incremental,
boolean validateExternal,
HrefValidationProgress progress)
throws AVMNotFoundException,
SocketException,
SSLException,
LinkValidationAbortedException;
//-------------------------------------------------------------------------
/**
* Fetch all hyperlinks that rely upon the existence of the file specified
* by 'path', directly or indirectly. The list of hrefs returnd is
* sorted in increasing lexicographic order. For example, in
* by 'path', directly or indirectly. The list of hrefs returnd is
* sorted in increasing lexicographic order. For example, in
* alfresco-sample-website.war, the hrefs dependent upon
* <code>mysite:/www/avm_webapps/ROOT/assets/footer.html</code> are:
* <pre>
@@ -191,10 +193,9 @@ public interface LinkValidationService
* http://mysite.www--sandbox.version--v-1.127-0-0-1.ip.alfrescodemo.net:8180/media/releases/index.jsp
* </pre>
* Note that this list may contain links that are functionally equivalent
* (e.g.: the first and third links), and may also contain links that
* (e.g.: the first and third links), and may also contain links that
* don't actually appear an any web page, but are implicitly present
* in the site because any asset can be "dead reckoned".
*
*
*/
//-------------------------------------------------------------------------