1 /* 2 * Copyright 2002 by 3 * <a HREF="http://www.coridan.com">Coridan</a> 4 * <a HREF="mailto: support@coridan.com ">support@coridan.com</a> 5 * 6 * The contents of this file are subject to the Mozilla Public License Version 7 * 1.1 (the "License"); you may not use this file except in compliance with the 8 * License. You may obtain a copy of the License at 9 * http://www.mozilla.org/MPL/ 10 * 11 * Software distributed under the License is distributed on an "AS IS" basis, 12 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License 13 * for the specific language governing rights and limitations under the 14 * License. 15 * 16 * The Original Code is "MantaRay" (TM). 17 * 18 * The Initial Developer of the Original Code is lital kasif. 19 * Portions created by the Initial Developer are Copyright (C) 2006 20 * Coridan Inc. All Rights Reserved. 21 * 22 * Contributor(s): all the names of the contributors are added in the source 23 * code where applicable. 24 * 25 * Alternatively, the contents of this file may be used under the terms of the 26 * LGPL license (the "GNU LESSER GENERAL PUBLIC LICENSE"), in which case the 27 * provisions of LGPL are applicable instead of those above. If you wish to 28 * allow use of your version of this file only under the terms of the LGPL 29 * License and not to allow others to use your version of this file under 30 * the MPL, indicate your decision by deleting the provisions above and 31 * replace them with the notice and other provisions required by the LGPL. 32 * If you do not delete the provisions above, a recipient may use your version 33 * of this file under either the MPL or the GNU LESSER GENERAL PUBLIC LICENSE. 34 35 * 36 * This library is free software; you can redistribute it and/or modify it 37 * under the terms of the MPL as stated above or under the terms of the GNU 38 * Lesser General Public License as published by the Free Software Foundation; 39 * either version 2.1 of the License, or any later version. 40 * 41 * This library is distributed in the hope that it will be useful, but WITHOUT 42 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 43 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 44 * License for more details. 45 * 46 * Created on Apr 28, 2005 47 * 48 * Coridan LTD 49 */ 50 package org.mr.kernel.services.topics; 51 52 /** 53 * TODO To change the template for this generated type comment go to 54 * Window - Preferences - Java - Code Style - Code Templates 55 * 56 * @author lital kasif 57 * 58 */ 59 public interface TopicServiceMBean { 60 /** 61 * Paused the topic. Pausing means producers will still be able to produce 62 * messages, but those messages will be held by the producers and not sent 63 * to the consumers until the topic is resumed again. 64 */ 65 public void pause(); 66 67 /** 68 * @return true if the queue is paused at the moment, false otherwise 69 */ 70 public boolean isPaused(); 71 72 /** 73 * resumes a topic that was paused. 74 */ 75 public void resume(); 76 77 /** 78 * Purges all the messages currently held by the topic producers. This method 79 * can be operated only after the topic has been paused. 80 */ 81 public void purge(); 82 } 83