1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
/*******************************************************************************
* Copyright (c) 2001, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.jem.internal.proxy.core;
/*
*/
/**
* The Standard base bean proxy factory.
* This is the Interface that the desktop will talk
* to.
* Creation date: (12/3/99 11:52:09 AM)
* @author: Joe Winchester
*/
public interface IStandardBeanProxyFactory extends IBeanProxyFactory {
/**
* Get the {@link org.eclipse.jem.internal.proxy.common.IVMServer} proxy for the
* this registry. This is only needed if you need to give the IVMserver to a proxy so that
* it can access it.
* <p>
* <b>Note:</b> Does not need to be given to callback proxies because they are given
* an {@link org.eclipse.jem.internal.proxy.common.IVMCallbackServer} on initialization, and
* that interface implements the IVMServer interface too.
*
* @return
*
* @since 1.1.0
*/
public IBeanProxy getIVMServerProxy();
/**
* Return a new bean proxy for the primitive integer argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public IIntegerBeanProxy createBeanProxyWith(int aPrimitiveInteger);
/**
* Return a new bean proxy for the primitive character argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public ICharacterBeanProxy createBeanProxyWith(char aPrimitiveCharacter);
/**
* Return a new bean proxy for the primitive byte argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public INumberBeanProxy createBeanProxyWith(byte aPrimitiveByte);
/**
* Return a new bean proxy for the primitive short argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public INumberBeanProxy createBeanProxyWith(short aPrimitiveShort);
/**
* Return a new bean proxy for the primitive long argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public INumberBeanProxy createBeanProxyWith(long aPrimitiveLong);
/**
* Return a new bean proxy for the primitive float argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public INumberBeanProxy createBeanProxyWith(float aPrimitiveFloat);
/**
* Return a new bean proxy for the primitive double argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public INumberBeanProxy createBeanProxyWith(double aPrimitiveDouble);
/**
* Return a new bean proxy for the Boolean argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public IBooleanBeanProxy createBeanProxyWith(Boolean aBoolean);
/**
* Return a new bean proxy for the Integer argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public IIntegerBeanProxy createBeanProxyWith(Integer anInteger);
/**
* Return a new bean proxy for the Character argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public ICharacterBeanProxy createBeanProxyWith(Character aCharacter);
/**
* Return a new bean proxy for the Number argument, can handle any of the numbers.
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public INumberBeanProxy createBeanProxyWith(Number aNumber);
/**
* Return a new bean proxy for the string argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public IStringBeanProxy createBeanProxyWith(String aString);
/**
* Convert the non-primitive proxy to a primitive proxy, if it
* of one of the wrapper types. If not, then just return the proxy as is.
* <p>
* I.E. BooleanClassProxy will convert to BooleanTypeProxy, but ObjectClassProxy will just return unchanged.
* @param nonPrimitiveProxy
* @return either the primitive proxy that nonPrimitive wrappers, or the non-primitive if not a wrapper type.
*
* @since 1.0.0
*/
public IBeanProxy convertToPrimitiveBeanProxy(IBeanProxy nonPrimitiveProxy);
/**
* Return a new bean proxy for the boolean argument
* Creation date: (12/3/99 11:52:20 AM)
* @author Joe Winchester
*/
public IBooleanBeanProxy createBeanProxyWith(boolean aBoolean);
/**
* Create an array bean proxy.
*
* - (int, new int[2] {3, 4}) will create:
* int [3] [4]
*
* - (int[], new int[1] {1})
* int [1]
*
* - (int[], new int[2] {2,3})
* int [2] [3]
*
*
* - (int[], null) or (int[], new int[0]) or (int, null) or (int, new int[0])
* int [0]...
* or
* (int[][]..., null) or (int[][]..., new int[0])
* int[0][]...
* This is because an array instance with no specified dimensions is not valid.
*
* - (int[][], new int[1] {3})
* int[3][]
*/
public IArrayBeanProxy createBeanProxyWith(IBeanTypeProxy type, int[] dimensions) throws ThrowableProxy;
/**
* Create a one-dimensional array.
* The result will be the same as calling
* createBeanProxyWith(IBeanTypeProxy type, new int[1] {x})
* where 'x' is the value passed in as the dimension.
*/
public IArrayBeanProxy createBeanProxyWith(IBeanTypeProxy type, int dimension) throws ThrowableProxy;
/**
* Create a bean proxy from an initialization string.
* <p>
* It is not recommended that this method be commonly used. That is because no type checking will be performed
* on the result. Whatever it evaluates to be will be what it is. It is useful for the rare cases where the desired
* result type is not known.
* <p>
* It is recommended instead to use the newInstance(initString) method on the appropriate IBeanTypeProxy so that the
* result can be type-checked to make sure the string evaluates to something of that type.
*
* @param initializationString
* @return
* @throws ThrowableProxy
* @throws InstantiationException
* @throws ClassCastException
*
* @since 1.0.0
*/
public IBeanProxy createBeanProxyFrom(String initializationString) throws ThrowableProxy, InstantiationException, ClassCastException;
/**
* Release the proxy. In the case of Remote VM, this means
* it will remove the proxy on the client side, and remove
* the reference to the real object on the server side. On the server
* side the real object may not go away because something else could
* be holding onto it, but it won't be held simply because the client
* is holding onto it.
*/
public void releaseProxy(IBeanProxy proxy);
/**
* Create an expression.
* @return The expression.
*
* @since 1.0.0
*/
public IExpression createExpression();
}
|
