/*
  neon - Embeddable HTTP Server based on jdk.httpserver
  Copyright (C) 2024  Ulrich Hilger

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as
  published by the Free Software Foundation, either version 3 of the
  License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
package de.uhilger.neon;

/**
 * Objekte, die auf Ereignisse von Neon lauschen wollen, 
 * muessen diese Schnittstelle implementieren.
 * 
 * Elemente eines Neon-Servers signalisieren, dass sie einen 
 * ServerDataProvider benoetigen, wenn sie die Schnittstelle 
 * ServerDataConsumer implementieren.
 * 
 * Objekte der Klasse ServerDataProvider muessen der Factory 
 * ueber die Methode putServerDataProvider uebergeben werden, 
 * bevor 
 * 
 * Die Methode Factory.runInstance erwartet als einen der Parameter 
 * eine Liste mit Objekten der Klasse ServerDataProvider. Diese 
 * hinterlegt die Factory in den Attributen jedes Kontexts unter 
 * 'serverDataProviderList'.
 * 
 * Der generische Neon-Handler registriert den oder die 
 * ServerDataProvider, wenn ein Actor instanziiert wird, der die 
 * Schnittstelle ServerDataConsumer implementiert. 
 * 
 * Die Bedeutung von Objektnamen und Datentypen sind nicht Teil der 
 * Spezifikation. Die Art der Nutzung dieser generischen Schnittstelle 
 * verbleibt damit bei der implementierenden Anwendung.
 * 
 * @author Ulrich Hilger
 */
public interface DataProvider {
  
  public Object getDataObject(String name);
  
}