001    /**
002     *   GRANITE DATA SERVICES
003     *   Copyright (C) 2006-2013 GRANITE DATA SERVICES S.A.S.
004     *
005     *   This file is part of the Granite Data Services Platform.
006     *
007     *   Granite Data Services is free software; you can redistribute it and/or
008     *   modify it under the terms of the GNU Lesser General Public
009     *   License as published by the Free Software Foundation; either
010     *   version 2.1 of the License, or (at your option) any later version.
011     *
012     *   Granite Data Services is distributed in the hope that it will be useful,
013     *   but WITHOUT ANY WARRANTY; without even the implied warranty of
014     *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
015     *   General Public License for more details.
016     *
017     *   You should have received a copy of the GNU Lesser General Public
018     *   License along with this library; if not, write to the Free Software
019     *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
020     *   USA, or see <http://www.gnu.org/licenses/>.
021     */
022    package org.granite.gravity;
023    
024    import java.util.Collection;
025    
026    
027    import flex.messaging.messages.AsyncMessage;
028    
029    /**
030     * @author Franck WOLFF
031     */
032    public interface Channel {
033    
034        public String getId();
035        
036        public String getClientType();
037        
038        public Gravity getGravity();
039        
040        public ChannelFactory<?> getFactory();
041    
042        public Subscription addSubscription(String destination, String subTopicId, String subscriptionId, boolean noLocal);
043        public Collection<Subscription> getSubscriptions();
044        public Subscription removeSubscription(String subscriptionId);
045    
046            public void publish(AsyncPublishedMessage message) throws MessagePublishingException;
047            public boolean hasPublishedMessage();
048            public boolean runPublish();
049            
050            public void receive(AsyncMessage message) throws MessageReceivingException;
051            public boolean hasReceivedMessage();
052            public boolean runReceive();
053            public boolean runReceived(AsyncHttpContext asyncHttpContext);
054        
055            public void close();
056        public void destroy(boolean timeout);
057    }