The platform adapter for Twitter allows Appkit applications to search Twitter or retrieve a user’s timeline using the Twitter API.

Setup

To add Twitter connectors to a Maven project, you must add this dependency to your project’s pom.xml file:
<dependency>
    <groupId>twigkit</groupId>
    <artifactId>twigkit.twitter</artifactId>
    <version>${project.parent.version}</version>
</dependency>

Usage

This example shows how to configure a Twitter platform.
name: twigkit.search.twitter.Twitter
oAuthConsumerKey: foo
oAuthConsumerSecret: foo
oAuthAccessToken: foo
oAuthAccessSecret: foo

Required attributes

  • oAuthConsumerKey (java.lang.String) OAuth consumer key for the Twitter API.
  • oAuthConsumerSecret (java.lang.String) OAuth consumer secret for the Twitter API.
  • oAuthAccessToken (java.lang.String) OAuth access token for the Twitter API.
  • oAuthAccessSecret (java.lang.String) OAuth access secret for the Twitter API.

Optional attributes

  • userTimeline (java.lang.String) User timeline to retrieve.

Attributes shared across platforms

  • host (java.lang.String) The URI of the platform. Must be specified using the full URI (for example, http://localhost:1234; localhost:1234 will not work).
  • name (java.lang.String) The display name of this Platform instance. Used for identifying different platforms in the user interface.
  • aliases (java.lang.String) Manage mappings from field names to aliases (use a comma-separated list). All references to the field (via this platform) in results, facets, filters, and query strings are mapped. For example, to refer to a field in the index named firstnamelastname as name and countryofresidence as country, use these mappings: aliases="firstnamelastname=name,countryofresidence=country"
  • defaultQuery (java.lang.String) Default query to use when none is specified.
  • defaultFacets (java.lang.String) Default facets to request when none are specified. This is a comma separated list.
  • spellCheck (java.lang.Boolean) Spellcheck the Query term if supported by the Platform.
    Default: true
  • expandQuery (java.lang.Boolean) Apply advanced linguistics such as stemming or lemmatization if supported by the Platform. Default: true
  • autoCorrect (java.lang.Boolean) Whether to auto-correct and resubmit futile queries (queries with zero results).
    Default: true
  • fileTypeField (java.lang.String) Set which field contains information about file type (mime type).
  • resultIDField (java.lang.String) Set which field represents the unique identifier for a given result.
  • pageLimit (java.lang.Long) A limitation to which page the platform will offset.