blob: d903fbb0ddd363f4a02b02f92134755e1561ad44 [file] [log] [blame]
Marc Kupietze95108e2019-09-18 13:23:58 +02001% Generated by roxygen2: do not edit by hand
2% Please edit documentation in R/KorAPConnection.R
3\docType{class}
4\name{KorAPConnection-class}
5\alias{KorAPConnection-class}
6\alias{KorAPConnection}
7\alias{initialize,KorAPConnection-method}
Marc Kupietzd0d3e9b2019-09-24 17:36:03 +02008\alias{apiCall,KorAPConnection-method}
9\alias{apiCall}
Marc Kupietz0a96b282019-10-01 11:05:31 +020010\alias{clearCache,KorAPConnection-method}
11\alias{clearCache}
Marc Kupietze95108e2019-09-18 13:23:58 +020012\alias{show,KorAPConnection-method}
13\title{Class KorAPConnection}
14\usage{
15\S4method{initialize}{KorAPConnection}(.Object,
Marc Kupietzf94a6c82019-09-19 11:32:07 +020016 KorAPUrl = "https://korap.ids-mannheim.de/", apiVersion = "v1.0",
Marc Kupietzd0d3e9b2019-09-24 17:36:03 +020017 apiUrl, userAgent = "R-KorAP-Client", timeout = 10,
Marc Kupietz0a96b282019-10-01 11:05:31 +020018 verbose = FALSE, cache = TRUE)
Marc Kupietzd0d3e9b2019-09-24 17:36:03 +020019
20\S4method{apiCall}{KorAPConnection}(kco, url)
Marc Kupietze95108e2019-09-18 13:23:58 +020021
Marc Kupietz0a96b282019-10-01 11:05:31 +020022\S4method{clearCache}{KorAPConnection}(kco)
23
Marc Kupietze95108e2019-09-18 13:23:58 +020024\S4method{show}{KorAPConnection}(object)
25}
26\arguments{
27\item{.Object}{KorAPConnection object}
28
29\item{KorAPUrl}{the URL of the KorAP server instance you want to access.}
30
31\item{apiVersion}{which version of KorAP's API you want to connect to.}
32
33\item{apiUrl}{URL of the KorAP web service.}
34
Marc Kupietzd0d3e9b2019-09-24 17:36:03 +020035\item{userAgent}{user agent string.}
36
37\item{timeout}{time out in seconds.}
38
Marc Kupietz7776dec2019-09-27 16:59:02 +020039\item{verbose}{logical. Decides whether following operations will default to be verbose.}
Marc Kupietz5a519822019-09-20 21:43:52 +020040
Marc Kupietz0a96b282019-10-01 11:05:31 +020041\item{cache}{logical. Decides if API calls are cached locally. You can clear the cache with \code{\link{clearCache}()}.}
42
Marc Kupietzd0d3e9b2019-09-24 17:36:03 +020043\item{kco}{KorAPConnection object}
44
45\item{url}{request url}
46
Marc Kupietze95108e2019-09-18 13:23:58 +020047\item{object}{KorAPConnection object}
48}
49\value{
50\code{\link{KorAPConnection}} object that can be used e.g. with \code{\link{corpusQuery}}
51}
52\description{
Marc Kupietz7776dec2019-09-27 16:59:02 +020053\code{KorAPConnection} objects represent the connection to a KorAP server.
54New \code{KorAPConnection} objects can be created by \code{KorAPConnection()}.
Marc Kupietze95108e2019-09-18 13:23:58 +020055}
56\note{
57Currently it is not possible to authenticate the client
58}
59\examples{
Marc Kupietz5a519822019-09-20 21:43:52 +020060kcon <- new("KorAPConnection", verbose = TRUE)
Marc Kupietze95108e2019-09-18 13:23:58 +020061kq <- corpusQuery(kcon, "Ameisenplage")
Marc Kupietz5a519822019-09-20 21:43:52 +020062kq <- fetchAll(kq)
Marc Kupietze95108e2019-09-18 13:23:58 +020063
64}