Class
TrackerEndpointHttp
since: 3.1
Description [src]
final class Tracker.EndpointHttp : Tracker.Endpoint
implements Gio.Initable {
/* No available fields */
}TrackerEndpointHttp makes the RDF data in a TrackerSparqlConnection
accessible to other hosts via HTTP.
This object is a TrackerEndpoint subclass that exports
a TrackerSparqlConnection so its RDF data is accessible via HTTP
requests on the given port. This endpoint implementation is compliant
with the SPARQL protocol specifications
and may interoperate with other implementations.
// This host has "example.local" hostname
endpoint = tracker_endpoint_http_new (sparql_connection,
8080,
tls_certificate,
NULL,
&error);
// From another host
connection = tracker_sparql_connection_remote_new ("http://example.local:8080/sparql");
Access to HTTP endpoints may be managed via the
TrackerEndpointHttp::block-remote-address signal, the boolean
return value expressing whether the connection is blocked or not.
Inspection of the requester address is left up to the user. The
default value allows all requests independently of their provenance,
users are encouraged to add a handler.
If the provided GTlsCertificate is NULL, the endpoint will allow
plain HTTP connections. Users are encouraged to provide a certificate
in order to use HTTPS.
As a security measure, and in compliance specifications,
the HTTP endpoint does not handle database updates or modifications in any
way. The database content is considered to be entirely managed by the
process that creates the HTTP endpoint and owns the TrackerSparqlConnection.
A TrackerEndpointHttp may be created on a different thread/main
context from the one that created TrackerSparqlConnection.
Available since: 3.1
Constructors
tracker_endpoint_http_new
Sets up a Tracker endpoint to listen via HTTP, in the given port.
If certificate is not NULL, HTTPS may be used to connect to the endpoint.
since: 3.1
Instance methods
Methods inherited from TrackerEndpoint (7)
tracker_endpoint_get_allowed_graphs
Returns the list of RDF graphs that the endpoint allows access for.
since: 3.7
tracker_endpoint_get_allowed_services
Returns the list of external SPARQL endpoints that are allowed to be accessed through this endpoint.
since: 3.7
tracker_endpoint_get_readonly
Returns whether the endpoint is readonly, thus SPARQL update queries are disallowed.
since: 3.7
tracker_endpoint_get_sparql_connection
Returns the TrackerSparqlConnection that this endpoint proxies
to a wider audience.
tracker_endpoint_set_allowed_graphs
Sets the list of RDF graphs that this endpoint will allow access
for. Any explicit (e.g. GRAPH keyword) or implicit (e.g. through the
default anonymous graph) access to RDF graphs unespecified in this
list in SPARQL queries will be seen as if those graphs did not exist, or
(equivalently) had an empty set. Changes to these graphs through SPARQL
updates will also be disallowed.
since: 3.7
tracker_endpoint_set_allowed_services
Sets the list of external SPARQL endpoints that this endpoint
will allow access for. Access through the SERVICE SPARQL syntax
will fail for services not specified in this list.
since: 3.7
tracker_endpoint_set_readonly
Sets whether the endpoint will be readonly. Readonly endpoints
will not allow SPARQL update queries. The underlying
TrackerSparqlConnection may be readonly of its own, this
method does not change its behavior in any way.
since: 3.7
Methods inherited from GInitable (1)
g_initable_init
Initializes the object implementing the interface.
Properties
Properties inherited from TrackerEndpoint (4)
Tracker.Endpoint:allowed-graphs
RDF graphs that are allowed to be accessed through queries to this endpoint. See tracker_endpoint_set_allowed_graphs().
since: 3.7
Tracker.Endpoint:allowed-services
External SPARQL endpoints that are allowed to be accessed through queries to this endpint. See tracker_endpoint_set_allowed_services().
since: 3.7
Tracker.Endpoint:readonly
Whether the endpoint allows SPARQL updates or not. See tracker_endpoint_set_readonly().
since: 3.7
Tracker.Endpoint:sparql-connection
The TrackerSparqlConnection being proxied by this endpoint.
Signals
Tracker.EndpointHttp::block-remote-address
Allows control over the connections stablished. The given address is that of the requesting peer.
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.