com.yahoo.application.container

Class JDisc

java.lang.Object

com.yahoo.application.container.JDisc

All Implemented Interfaces:

AutoCloseable

@Beta
public final class JDisc
extends Object
implements AutoCloseable

A JDisc Container configured from XML.

Author:

Tony Vaagenes, Einar M R Rosenvinge, gjoranv

Field Summary

Fields

Modifier and Type	Field and Description
private com.yahoo.container.standalone.StandaloneContainerApplication	application
private com.yahoo.container.Container	container
private boolean	deletePathWhenClosing
private com.yahoo.application.container.impl.ClassLoaderOsgiFramework	osgiFramework
private Path	path
private com.yahoo.jdisc.test.TestDriver	testDriver

Constructor Summary

Constructors

Modifier	Constructor and Description
private	JDisc(Path path, boolean deletePathWhenClosing, Networking networking, com.yahoo.config.model.ConfigModelRepo configModelRepo)

Method Summary

Modifier and Type	Method and Description
private com.google.inject.Module	bindings(Path path, com.yahoo.config.model.ConfigModelRepo configModelRepo, Networking networking)
void	close() Closes the current JDisc.
com.yahoo.component.provider.ComponentRegistry<com.yahoo.component.AbstractComponent>	components() Returns a registry of all components available in this
DocumentProcessing	documentProcessing() Returns a DocumentProcessing, used to process objects of type Document, DocumentRemove and DocumentUpdate.
static JDisc	fromPath(Path path, Networking networking) Factory method to create a JDisc from an application package.
static JDisc	fromPath(Path path, Networking networking, com.yahoo.config.model.ConfigModelRepo configModelRepo) Create a jDisc instance which is given a config model repo (in which (mock) content clusters can be looked up).
static JDisc	fromServicesXml(String xml, Networking networking) Factory method to create a JDisc from an XML String.
private com.yahoo.search.handler.SearchHandler	getSearchHandler()
Response	handleRequest(Request request) Handles the given Request by passing it to the RequestHandler that is bound to the request's URI.
Processing	processing() Returns a Processing, used to do generic asynchronous operations in a request/response API.
Search	search() Returns a Search, used to perform search query operations on this container.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

osgiFramework

private final com.yahoo.application.container.impl.ClassLoaderOsgiFramework osgiFramework

testDriver

private final com.yahoo.jdisc.test.TestDriver testDriver

application

private final com.yahoo.container.standalone.StandaloneContainerApplication application

container

private final com.yahoo.container.Container container

path

private final Path path

deletePathWhenClosing

private final boolean deletePathWhenClosing

Constructor Detail

JDisc

private JDisc(Path path,
              boolean deletePathWhenClosing,
              Networking networking,
              com.yahoo.config.model.ConfigModelRepo configModelRepo)

Method Detail

bindings

private com.google.inject.Module bindings(Path path,
                                          com.yahoo.config.model.ConfigModelRepo configModelRepo,
                                          Networking networking)

fromServicesXml

public static JDisc fromServicesXml(String xml,
                                    Networking networking)

Factory method to create a JDisc from an XML String. Note that any components that are referenced in the XML must be present on the classpath. To deploy OSGi bundles in memory, use fromPath(java.nio.file.Path, com.yahoo.application.Networking).

Parameters:

xml - the XML configuration to use

Returns:

a new JDisc instance

fromPath

public static JDisc fromPath(Path path,
                             Networking networking)

Factory method to create a JDisc from an application package. This method allows deploying OSGi bundles(contained in the components subdirectory). All the OSGi bundles will share the same class loader.

Parameters:

path - the reference to the application package to use

networking - enabled or disabled

Returns:

a new JDisc instance

fromPath

public static JDisc fromPath(Path path,
                             Networking networking,
                             com.yahoo.config.model.ConfigModelRepo configModelRepo)

Create a jDisc instance which is given a config model repo (in which (mock) content clusters can be looked up).

search

public Search search()

Returns a Search, used to perform search query operations on this container.

Returns:

a Search instance

Throws:

UnsupportedOperationException - if this JDisc does not have search configured

getSearchHandler

private com.yahoo.search.handler.SearchHandler getSearchHandler()

processing

public Processing processing()

Returns a Processing, used to do generic asynchronous operations in a request/response API.

Returns:

a Processing instance

Throws:

UnsupportedOperationException - if this JDisc does not have processing configured

documentProcessing

public DocumentProcessing documentProcessing()

Returns a DocumentProcessing, used to process objects of type Document, DocumentRemove and DocumentUpdate.

Returns:

a DocumentProcessing instance

Throws:

UnsupportedOperationException - if this JDisc does not have document processing configured

components

public com.yahoo.component.provider.ComponentRegistry<com.yahoo.component.AbstractComponent> components()

Returns a registry of all components available in this

handleRequest

public Response handleRequest(Request request)

Handles the given Request by passing it to the RequestHandler that is bound to the request's URI.

Parameters:

request - the request to process

Returns:

a response for the given request

close

public void close()

Closes the current JDisc.

Specified by:

close in interface AutoCloseable