"{ Encoding: utf8 }"
"
COPYRIGHT (c) 1996-2015 by Claus Gittinger
New code and modifications done at SWING Research Group [1]:
COPYRIGHT (c) 2010-2015 by Jan Vrany, Jan Kurs and Marcel Hlopko
SWING Research Group, Czech Technical University in Prague
This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.
[1] Code written at SWING Research Group contains a signature
of one of the above copright owners. For exact set of such code,
see the differences between this version and version stx:libjava
as of 1.9.2010
"
"{ Package: 'stx:libjava' }"
"{ NameSpace: Smalltalk }"
Object subclass:#JavaRef2
instanceVariableNames:'resolvedValue constantPool'
classVariableNames:''
poolDictionaries:''
category:'Languages-Java-Reader-Support-new'
!
!JavaRef2 class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 1996-2015 by Claus Gittinger
New code and modifications done at SWING Research Group [1]:
COPYRIGHT (c) 2010-2015 by Jan Vrany, Jan Kurs and Marcel Hlopko
SWING Research Group, Czech Technical University in Prague
This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.
[1] Code written at SWING Research Group contains a signature
of one of the above copright owners. For exact set of such code,
see the differences between this version and version stx:libjava
as of 1.9.2010
"
!
documentation
"
An abstract superclass for symbolic references in Java class files.
A reference is either ''unresolved'' (when `resolvedValue` instvar nil)
or ''resolved'' (when ``resolvedValue`` instvar is not nil).
IMPORTANT: The exact physical structure of (sub)instances is known
by the VM and therefore changing number, order or meaning of individual
instance variables would imply to change the VM accordingly.
See comments in individual subclasses which instvars are accessed by the VM.
IMPORTANT: There's a naming convention:
Slots whose name starts with ''resolved'' are valid only after the reference
is resolved. Otherwise, they MUST have nil value.
Other slots MUST be valid once JavaClassReader finishes reading of the
.class file.
[author:]
Marcel Hlopko <marcel.hlopko@fit.cvut.cz>
Jan Vrany <jan.vrany@fit.cvut.cz>
[instance variables:]
!! resolvedValue ..... resolved value whatever it is (class, method, field...).
It also serve as an indicator whether the reference
is unresolved (nil value) or resolved (non-nil value).
!!!!!! Used by the VM !!!!!!
constantPool ...... a constant pool to which this reference belongs.
[class variables:]
[see also:]
Subclasses
"
! !
!JavaRef2 class methodsFor:'instance creation'!
new
"Don't call me directly"
self shouldNotImplement
"Modified: / 06-12-2011 / 17:02:11 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified: / 02-03-2015 / 15:55:02 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !
!JavaRef2 methodsFor:'accessing'!
constantPool
^constantPool.
"Created: / 10-05-2011 / 17:16:23 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
!
constantPool: aJavaConstantPool
constantPool := aJavaConstantPool.
"Created: / 10-05-2011 / 17:16:37 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
!
isResolved
^ resolvedValue notNil.
"Created: / 08-04-2011 / 11:36:03 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified: / 08-04-2011 / 17:39:42 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified: / 31-01-2014 / 02:30:42 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!
name
^ self subclassResponsibility.
"Created: / 08-04-2011 / 13:53:30 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
!
owner
^ constantPool owner.
"Modified: / 12-05-2011 / 18:31:34 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
!
owner: javaClass
constantPool owner: javaClass.
"Modified: / 12-05-2011 / 18:32:04 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
!
resolvedValue
^ resolvedValue
! !
!JavaRef2 methodsFor:'comparing'!
= anotherJavaRef
^ self subclassResponsibility.
"Created: / 08-04-2011 / 12:15:36 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified (format): / 31-01-2014 / 03:14:33 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!
hash
^ self subclassResponsibility.
"Created: / 08-04-2011 / 12:15:51 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified (format): / 31-01-2014 / 03:14:27 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !
!JavaRef2 methodsFor:'initialization'!
initialize
resolvedValue := nil.
super initialize.
"Modified: / 08-04-2011 / 17:39:23 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
! !
!JavaRef2 methodsFor:'printing'!
displayString
^self subclassResponsibility
"Created: / 14-08-2011 / 21:18:41 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !
!JavaRef2 methodsFor:'private - resolving'!
findResolvedValue
self findResolvedValue: true.
"Modified: / 09-02-2012 / 23:10:09 / mh <hlopik@gmail.com>"
!
findResolvedValue: doInit
"Resolves reference. If doInit is true, then eventually
initialize the class"
self subclassResponsibility
"Created: / 09-02-2012 / 23:08:15 / mh <hlopik@gmail.com>"
"Modified: / 10-04-2012 / 09:31:50 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !
!JavaRef2 methodsFor:'queries'!
isJavaRef
"return true if object represents reference in java constant pool"
^ true.
"Created: / 08-04-2011 / 16:15:05 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
!
isNewJavaRef
"only temporary, to know if ref is old (claus' version) or new (m version)"
^ true.
"Created: / 10-05-2011 / 12:20:05 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
! !
!JavaRef2 methodsFor:'resolving'!
invalidate
"Invalidate reference. Cache will be cleared and next call to resolve will
cause resolving from scratch. Return true if reference was resolved and
thus invalidates or false otherwise"
| invalidated |
invalidated := resolvedValue notNil.
resolvedValue := nil.
^ invalidated
"Created: / 08-04-2011 / 11:42:43 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified: / 08-04-2011 / 17:39:28 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified: / 07-08-2014 / 14:38:05 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!
invalidateForClass: internalJavaClassName
"Invalidates receiver iff it refers (even indirectly)
to a class ref that has been resolved to given class.
Returns true, if the receiver has been invalidated,
false otherwise"
^ self subclassResponsibility.
"Created: / 08-04-2011 / 15:59:57 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified (comment): / 21-02-2012 / 10:20:46 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!
preResolve
"Pre-resolve some caches. Called when the constant pool
is loaded. MUST NOT load new nor modify any existing class!!!!!!
Ask JV for what this is needed"
"Nothing by default"
"Created: / 15-10-2012 / 23:13:53 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!
resolve
"
Do it all method - resolves current reference and returns expected element (JavaMethod, JavaField etc.)
Hides implementation details of the way of dealing with invalidation etc. User should not need to call anything
else."
^ self resolve: true.
"Created: / 08-04-2011 / 11:30:21 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Modified: / 23-02-2012 / 17:21:39 / Marcel Hlopko <hlopik@gmail.com>"
"Modified (format): / 31-01-2014 / 09:08:21 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!
resolve: doClassInit
"Do it all method - resolves current reference and returns expected element (JavaMethod, JavaField etc.)
If doClassInit is true, resolved class is initialized (if not already)
Hides implementation details of the way of dealing with invalidation etc. User should not need to call anything
else."
self isResolved ifFalse: [
constantPool owner synchronized:[
self isResolved ifFalse:[
self findResolvedValue: doClassInit.
JavaVM flushCachesFor: constantPool owner.
].
]
].
^ resolvedValue.
"Created: / 08-04-2011 / 11:30:21 / Marcel Hlopko <hlopkmar@fel.cvut.cz>"
"Created: / 09-02-2012 / 23:08:15 / mh <hlopik@gmail.com>"
"Modified: / 23-12-2013 / 23:02:35 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !
!JavaRef2 methodsFor:'testing'!
isUnresolved
^resolvedValue isNil
"Created: / 22-05-2011 / 14:01:26 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !
!JavaRef2 class methodsFor:'documentation'!
version_CVS
^ '$Header: /cvs/stx/stx/libjava/JavaRef2.st,v 1.8 2015-03-20 12:08:00 vrany Exp $'
!
version_HG
^ '$Changeset: <not expanded> $'
!
version_SVN
^ 'Id'
! !