English
- /*
- * Copyright (C) 2007 Esmertec AG.
- * Copyright (C) 2007 The Android Open Source Project
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
- package com.android.im.engine;
- import java.util.Vector;
- import java.util.concurrent.CopyOnWriteArrayList;
- /**
- * The ChatSessionManager keeps track of all current chat sessions and is also
- * responsible to dispatch the new incoming message to the right session.
- */
- public abstract class ChatSessionManager {
- private CopyOnWriteArrayList<ChatSessionListener> mListeners;
- /** Map session to the participant communicate with. */
- protected Vector<ChatSession> mSessions;
- protected ChatSessionManager() {
- mListeners = new CopyOnWriteArrayList<ChatSessionListener>();
- mSessions = new Vector<ChatSession>();
- }
- /**
- * Registers a ChatSessionListener with the ChatSessionManager to receive
- * events related to ChatSession.
- *
- * @param listener the listener
- */
- public synchronized void addChatSessionListener(ChatSessionListener listener) {
- if ((listener != null) && !mListeners.contains(listener)) {
- mListeners.add(listener);
- }
- }
- /**
- * Removes a ChatSessionListener so that it will no longer be notified.
- *
- * @param listener the listener to remove.
- */
- public synchronized void removeChatSessionListener(ChatSessionListener listener) {
- mListeners.remove(listener);
- }
- /**
- * Creates a new ChatSession with specified participant.
- *
- * @param participant the participant.
- * @return the created ChatSession.
- */
- public synchronized ChatSession createChatSession(ImEntity participant) {
- for(ChatSession session : mSessions) {
- if(session.getParticipant().equals(participant)) {
- return session;
- }
- }
- ChatSession session = new ChatSession(participant, this);
- for (ChatSessionListener listener : mListeners) {
- listener.onChatSessionCreated(session);
- }
- mSessions.add(session);
- return session;
- }
- /**
- * Closes a ChatSession. This only removes the session from the list; the
- * protocol implementation should override this if it has special work to
- * do.
- *
- * @param session the ChatSession to close.
- */
- public void closeChatSession(ChatSession session) {
- mSessions.remove(session);
- }
- /**
- * Sends a message to specified participant(s) asynchronously.
- * TODO: more docs on async callbacks.
- *
- * @param message the message to send.
- */
- protected abstract void sendMessageAsync(ChatSession session, Message message);
- }
