Gateway (SciJava Common 2.49.0 API)

All Superinterfaces:

Comparable<Prioritized>, Contextual, HasPluginInfo, Prioritized, RichPlugin, SciJavaPlugin, Versioned

All Known Implementing Classes:

AbstractGateway, SciJava
```
public interface Gateway
extends RichPlugin, Versioned
```
Interface for convenience classes that wrap a Context to provide one-line access to a suite of Services.
The get(java.lang.Class<S>) methods provide consistent Service instantiation, while throwing NoSuchServiceException if the requested Service is not found.

Sample implementation

Let's say we have a Kraken service and a Cow service. Using the Context directly, the code would look like:
```
 Context context = new Context();
 context.getService(Cow.class).feedToKraken();
 context.getService(Kraken.class).burp();
```
To perform these actions, you have to know a priori to ask for a Cow and a Kraken; i.e., your IDE's code completion will not give you a hint. Further, if either service is unavailable, a NullPointerException is thrown.

But if we create a Gateway class called Animals with the following signatures:
```
 public Cow cow() { return get(Cow.class); }
 public Kraken kraken() { return get(Kraken.class); }
```
We can now access our services through the new Animals gateway:
```
 Animals animals = new Animals();
 animals.cow().feedToKraken();
 animals.kraken().burp();
```
This provides succinct yet explicit access to the Cow and Kraken services; it is a simple two-layer access to functionality, which an IDE can auto-complete. And if one of the services is not available, a NoSuchServiceException is thrown, which facilitates appropriate (but optional) handling of missing services.

Gateways discoverable at runtime must implement this interface and be annotated with @Gateway with attribute Plugin.type() = Gateway.class. While it possible to create a gateway merely by implementing this interface, it is encouraged to instead extend AbstractGateway, for convenience.
Author:

Mark Hiner, Curtis Rueden

See Also:
Context

Method Summary

Methods
Modifier and Type	Method and Description
`AppService`	`app()` Gets this application context's `AppService`.
`AppEventService`	`appEvent()` Gets this application context's `AppEventService`.
`CommandService`	`command()` Gets this application context's `CommandService`.
`ConsoleService`	`console()` Gets this application context's `ConsoleService`.
`DisplayService`	`display()` Gets this application context's `DisplayService`.
`EventService`	`event()` Gets this application context's `EventService`.
`EventHistory`	`eventHistory()` Gets this application context's `EventHistory`.
`<S extends Service> S`	`get(Class<S> serviceClass)` Returns an implementation of the requested `Service`, if it exists in the underlying `Context`.
`Service`	`get(String serviceClassName)` Returns an implementation of the `Service` with the given class name, if it exists in the underlying `Context`.
`App`	`getApp()`
`String`	`getInfo(boolean mem)`
`String`	`getTitle()`
`String`	`getVersion()` Gets the version of the object.
`IconService`	`icon()` Gets this application context's `IconService`.
`InputService`	`input()` Gets this application context's `InputService`.
`IOService`	`io()` Gets this application context's `IOService`.
`LogService`	`log()` Gets this application context's `LogService`.
`MenuService`	`menu()` Gets this application context's `MenuService`.
`ModuleService`	`module()` Gets this application context's `ModuleService`.
`ObjectService`	`object()` Gets this application context's `ObjectService`.
`OptionsService`	`options()` Gets this application context's `OptionsService`.
`PlatformService`	`platform()` Gets this application context's `PlatformService`.
`PluginService`	`plugin()` Gets this application context's `PluginService`.
`RecentFileService`	`recentFile()` Gets this application context's `RecentFileService`.
`ScriptService`	`script()` Gets this application context's `ScriptService`.
`StatusService`	`status()` Gets this application context's `StatusService`.
`TextService`	`text()` Gets this application context's `TextService`.
`ThreadService`	`thread()` Gets this application context's `ThreadService`.
`ToolService`	`tool()` Gets this application context's `ToolService`.
`WidgetService`	`widget()` Gets this application context's `WidgetService`.

Methods inherited from interface org.scijava.Contextual
context, getContext, setContext

Methods inherited from interface org.scijava.Prioritized
getPriority, setPriority

Methods inherited from interface java.lang.Comparable
compareTo

Methods inherited from interface org.scijava.plugin.HasPluginInfo
getInfo, setInfo

- Method Detail
  - get
```
<S extends Service> S get(Class<S> serviceClass)
```
    Returns an implementation of the requested Service, if it exists in the underlying Context.
    
    Parameters:
    serviceClass - the requested Service
    
    Returns:
    The singleton instance of the given class
    
    Throws:
    
    NullContextException - if the application context is not set.
    
    NoSuchServiceException - if there is no service of the given class.
  - get
```
Service get(String serviceClassName)
```
    Returns an implementation of the Service with the given class name, if it exists in the underlying Context.
    
    Parameters:
    serviceClassName - name of the requested Service
    
    Returns:
    The singleton instance of the requested Service
    
    Throws:
    
    NullContextException - if the application context is not set.
    
    NoSuchServiceException - if there is no service matching serviceClassName.
  - appEvent
```
AppEventService appEvent()
```
    Gets this application context's AppEventService.
    
    Returns:
    The AppEventService of this application context.
  - app
```
AppService app()
```
    Gets this application context's AppService.
    
    Returns:
    The AppService of this application context.
  - command
```
CommandService command()
```
    Gets this application context's CommandService.
    
    Returns:
    The CommandService of this application context.
  - console
```
ConsoleService console()
```
    Gets this application context's ConsoleService.
    
    Returns:
    The ConsoleService of this application context.
  - display
```
DisplayService display()
```
    Gets this application context's DisplayService.
    
    Returns:
    The DisplayService of this application context.
  - eventHistory
```
EventHistory eventHistory()
```
    Gets this application context's EventHistory.
    
    Returns:
    The EventHistory of this application context.
  - event
```
EventService event()
```
    Gets this application context's EventService.
    
    Returns:
    The EventService of this application context.
  - icon
```
IconService icon()
```
    Gets this application context's IconService.
    
    Returns:
    The IconService of this application context.
  - input
```
InputService input()
```
    Gets this application context's InputService.
    
    Returns:
    The InputService of this application context.
  - io
```
IOService io()
```
    Gets this application context's IOService.
    
    Returns:
    The IOService of this application context.
  - log
```
LogService log()
```
    Gets this application context's LogService.
    
    Returns:
    The LogService of this application context.
  - menu
```
MenuService menu()
```
    Gets this application context's MenuService.
    
    Returns:
    The MenuService of this application context.
  - module
```
ModuleService module()
```
    Gets this application context's ModuleService.
    
    Returns:
    The ModuleService of this application context.
  - object
```
ObjectService object()
```
    Gets this application context's ObjectService.
    
    Returns:
    The ObjectService of this application context.
  - options
```
OptionsService options()
```
    Gets this application context's OptionsService.
    
    Returns:
    The OptionsService of this application context.
  - platform
```
PlatformService platform()
```
    Gets this application context's PlatformService.
    
    Returns:
    The PlatformService of this application context.
  - plugin
```
PluginService plugin()
```
    Gets this application context's PluginService.
    
    Returns:
    The PluginService of this application context.
  - recentFile
```
RecentFileService recentFile()
```
    Gets this application context's RecentFileService.
    
    Returns:
    The RecentFileService of this application context.
  - script
```
ScriptService script()
```
    Gets this application context's ScriptService.
    
    Returns:
    The ScriptService of this application context.
  - status
```
StatusService status()
```
    Gets this application context's StatusService.
    
    Returns:
    The StatusService of this application context.
  - text
```
TextService text()
```
    Gets this application context's TextService.
    
    Returns:
    The TextService of this application context.
  - thread
```
ThreadService thread()
```
    Gets this application context's ThreadService.
    
    Returns:
    The ThreadService of this application context.
  - tool
```
ToolService tool()
```
    Gets this application context's ToolService.
    
    Returns:
    The ToolService of this application context.
  - widget
```
WidgetService widget()
```
    Gets this application context's WidgetService.
    
    Returns:
    The WidgetService of this application context.
  - getApp
```
App getApp()
```
    See Also:
    AppService
  - getTitle
```
String getTitle()
```
    See Also:
    App.getTitle()
  - getInfo
```
String getInfo(boolean mem)
```
    See Also:
    App.getInfo(boolean)
  - getVersion
```
String getVersion()
```
    Description copied from interface: Versioned
    
    Gets the version of the object.
    
    Specified by:
    
    getVersion in interface Versioned
    
    See Also:
    App.getVersion()

Interface Gateway

Sample implementation

Method Summary

Methods inherited from interface org.scijava.Contextual

Methods inherited from interface org.scijava.Prioritized

Methods inherited from interface java.lang.Comparable

Methods inherited from interface org.scijava.plugin.HasPluginInfo

Method Detail

get

get

appEvent

app

command

console

display

eventHistory

event

icon

input

io

log

menu

module

object

options

platform

plugin

recentFile

script

status

text

thread

tool

widget

getApp

getTitle

getInfo

getVersion