KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > archive > crawler > url > CanonicalizationRule


1 /* CanonicalizationRule
2  *
3  * Created on Oct 7, 2004
4  *
5  * Copyright (C) 2004 Internet Archive.
6  *
7  * This file is part of the Heritrix web crawler (crawler.archive.org).
8  *
9  * Heritrix is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU Lesser Public License as published by
11  * the Free Software Foundation; either version 2.1 of the License, or
12  * any later version.
13  *
14  * Heritrix is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU Lesser Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser Public License
20  * along with Heritrix; if not, write to the Free Software
21  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22  */

23 package org.archive.crawler.url;
24
25
26 /**
27  * A rule to apply canonicalizing a url.
28  * @author stack
29  * @version $Date: 2004/10/08 17:39:41 $, $Revision: 1.2 $
30  */

31 public interface CanonicalizationRule {
32     /**
33      * Apply this canonicalization rule.
34      *
35      * @param url Url string we apply this rule to.
36      * @param context An object that will provide context for the settings
37      * system. The UURI of the URL we're canonicalizing is an example of
38      * an object that provides context.
39      * @return Result of applying this rule to passed <code>url</code>.
40      */

41     public String JavaDoc canonicalize(String JavaDoc url, Object JavaDoc context);
42
43     /**
44      * @return Name of this rule.
45      */

46     public String JavaDoc getName();
47     
48     /**
49      * @param context An object that will provide context for the settings
50      * system. The UURI of the URL we're canonicalizing is an example of
51      * an object that provides context.
52      * @return True if this rule is enabled and to be run.
53      */

54     public boolean isEnabled(Object JavaDoc context);
55 }
56
Popular Tags