KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > jac > aspects > session > SessionConf


1 /*
2   Copyright (C) 2003 Renaud Pawlak
3
4   This program is free software; you can redistribute it and/or modify
5   it under the terms of the GNU Lesser General Public License as
6   published by the Free Software Foundation; either version 2 of the
7   License, or (at your option) any later version.
8
9   This program is distributed in the hope that it will be useful,
10   but WITHOUT ANY WARRANTY; without even the implied warranty of
11   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12   GNU Lesser General Public License for more details.
13
14   You should have received a copy of the GNU Lesser General Public License
15   along with this program; if not, write to the Free Software
16   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
17
18 package org.objectweb.jac.aspects.session;
19
20 /**
21  * This is the configuration interface of the session aspect.
22  *
23  * @see SessionAC
24  *
25  * @author Renaud Pawlak */
26
27 public interface SessionConf {
28
29    /**
30     * This configuration method tells which methods of which objects
31     * must handdle the sessions (wrapped by the session wrapper).
32     *
33     * @param classExpr a class pointcut expression
34     * @param methodExpr a method pointcut expression
35     * @param objectExpr an object pointcut expression
36     *
37     * @see org.objectweb.jac.aspects.session.SessionWrapper */
38
39    void defineSessionHandlers(String JavaDoc classExpr, String JavaDoc methodExpr, String JavaDoc objectExpr);
40
41    /**
42     * This configuration method defines per-session objects.
43     *
44     * <p>A per-session object is an object that have a different state
45     * depending on the session. Each user will see a different state
46     * for the same object.
47     *
48     * <p>Warning: this feature is not compatible with persistent
49     * objects!
50     *
51     * @param classExpr a class pointcut expression
52     * @param objectExpr an object pointcut expression
53     *
54     * @see org.objectweb.jac.aspects.session.SessionWrapper */
55
56    void definePerSessionObjects(String JavaDoc classExpr, String JavaDoc objectExpr);
57
58    /**
59     * Add some attributes to the list of attributes of the context to
60     * be saved and restored by the session aspect.
61     * @param attributes names of attributes
62     */
63    void declareStoredAttributes(String JavaDoc attributes[]);
64
65 }
66
Popular Tags