head	1.3;
access;
symbols;
locks
	http:1.3; strict;
comment	@# @;
expand	@b@;


1.3
date	2003.07.06.17.21.05;	author MartinHill;	state Exp;
branches;
next	1.2;

1.2
date	2003.07.06.17.16.33;	author MartinHill;	state Exp;
branches;
next	1.1;

1.1
date	2003.07.06.17.09.42;	author MartinHill;	state Exp;
branches;
next	;


desc
@none
@


1.3
log
@none
@
text
@/*
 $Id: AceConsumer.java,v 1.1 2003/06/18 15:59:51 mch Exp $

 (c) Copyright...
 */


package org.astrogrid.ace.client;

import java.io.InputStream;

/**
 * Applications that want to use ACE, such as Aladin, will tend to want ACE
 * to display the dialog box modally, and then go off and get the results
 * asynchronously.
 * <p>
 * This class provides that callback mechanism.  The calling application implements
 * it (or provides an implementation of it), calls AceProducer with a reference to it, and
 * ACE then calls the <code>consumeAceResults()</code> method with the votable as
 * an InputStream
 * <P>
 * NB - the method to be implemented here is likely to be called by a separate extraction
 * thread generated by ACE, so watch out for synchronisation issues.
 * <p>
 * Implementation point - <code>VotConsumer</code> is the default consumer for
 * ACE, which provides the VOTable as an XML document (ie DOM node) rather than
 * as an InputStream.  So to use this interface, call AceProducer with an implementation
 * of this class. AceProducer uses <code>VOT2InputPipe</code>
 * to do the conversion.
 */

public interface AceConsumer
{
   public void consumeAceResults(InputStream results);
}


/*
$Log: AceConsumer.java,v $
Revision 1.1  2003/06/18 15:59:51  mch
Introdueced to remove circular dependency with Aladin

*/

@


1.2
log
@Code for Aladin/ACE interface; Aladin implements
@
text
@d13 16
a28 3
 * Provides a callback mechanism for applications that use ACE.  See <code>VotConsumer</code>
 * for use.  This interface differs in that it expects the VOTable as an InputStream
 * rather than an XML document (DOM element).   ACE uses <code>VOT2InputPipe</code>
@


1.1
log
@Code for Aladin/ACE interface; Aladin implements
@
text
@a0 1

d13 4
a16 2
 * See VotConsumer - this is for those applications that need the results
 * in an InputStream rather than as XML elements
d23 1
@