01: /*
02: (c) Copyright 2007, 2008 Hewlett-Packard Development Company, LP
03: All rights reserved.
04: $Id: GraphStatisticsHandler.java,v 1.3 2008/01/02 12:06:55 andy_seaborne Exp $
05: */
06:
07: package com.hp.hpl.jena.graph;
08:
09: /**
10: A graph's StatisticsHandler offers access to some statistics about that
11: graph's contents that might be useful for optimisation.
12:
13: @author kers
14: */
15: public interface GraphStatisticsHandler {
16: /**
17: Answer a good estimate of the number of triples that would match the
18: pattern <code>(S, P, O)</code>, or -1 if no good estimate is available.
19: The estimate is good until the graph is updated.
20: */
21: public long getStatistic(Node S, Node P, Node O);
22: }
23:
24: /*
25: * (c) Copyright 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
26: * All rights reserved.
27: *
28: * Redistribution and use in source and binary forms, with or without
29: * modification, are permitted provided that the following conditions
30: * are met:
31: * 1. Redistributions of source code must retain the above copyright
32: * notice, this list of conditions and the following disclaimer.
33: * 2. Redistributions in binary form must reproduce the above copyright
34: * notice, this list of conditions and the following disclaimer in the
35: * documentation and/or other materials provided with the distribution.
36: * 3. The name of the author may not be used to endorse or promote products
37: * derived from this software without specific prior written permission.
38: *
39: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
40: * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
41: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
42: * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
43: * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
45: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
46: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
47: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
48: * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
49: */
|