path: root/src/algebra/java.spad.pamphlet

\documentclass{article}
\usepackage{open-axiom}

\author{Gabriel Dos~Reis}

\begin{document}

\begin{abstract}
\end{abstract}

\tableofcontents
\eject

\section{Class file access flags}

<<domain JVMCFACC JVMClassFileAccess>>=
)abbrev domain JVMCFACC JVMClassFileAccess
++ Date Created: July 18, 2008
++ Data Last Modified: July 18, 2010
++ Description:  JVM class file access bitmask and values.
JVMClassFileAccess: Public == Private where
  Public == Join(SetCategory,Logic) with
    jvmPublic: %
      ++ The class was declared public, therefore may be accessed
      ++ from outside its package
    jvmFinal: %
      ++ The class was declared final; therefore no derived class allowed.
    jvmSuper: %
      ++ Instruct the JVM to treat base clss method invokation specially.
    jvmInterface: %
      ++ The class file represents an interface, not a class.
    jvmAbstract: %
      ++ The class was declared abstract; therefore object of this class
      ++ may not be created.
  Private == UInt16 add
    jvmPublic == per(16r0001::Rep)
    jvmFinal == per(16r0010::Rep)
    jvmSuper == per(16r0020::Rep)
    jvmInterface == per(16r0200::Rep)
    jvmAbstract == per(16r0400::Rep)
@

\section{JVM field access flags}

<<domain JVMFDACC JVMFieldAccess>>=
)abbrev domain JVMFDACC JVMFieldAccess
++ Date Created: July 18, 2008
++ Data Last Modified: July 18, 2010
++ Description:
++   JVM class field access bitmask and values.
JVMFieldAccess: Public == Private where
  Public == Join(SetCategory,Logic) with
    jvmPublic: %
      ++ The field was declared public; therefore mey accessed from
      ++ outside its package.
    jvmPrivate: %
      ++ The field was declared private; threfore can be accessed only
      ++ within the defining class.
    jvmProtected: %
      ++ The field was declared protected; therefore may be accessed
      ++ withing derived classes.
    jvmStatic: %
      ++ The field was declared static.
    jvmFinal: %
      ++ The field was declared final; therefore may not be modified
      ++ after initialization.
    jvmVolatile: %
      ++ The field was declared volatile.
    jvmTransient: %
      ++ The field was declared transient.
  Private == UInt16 add
    jvmPublic == per(16r0001::Rep)
    jvmPrivate == per(16r0002::Rep)
    jvmProtected == per(16r0004::Rep)
    jvmStatic == per(16r0008::Rep)
    jvmFinal == per(16r0010::Rep)
    jvmVolatile == per(16r0040::Rep)
    jvmTransient == per(16r0080::Rep)
@


\section{JVM method access flags}

<<domain JVMMDACC JVMMethodAccess>>=
)abbrev domain JVMMDACC JVMMethodAccess
)abbrev domain JVMFDACC JVMFieldAccess
++ Date Created: July 18, 2008
++ Data Last Modified: July 18, 2010
++ Description:
++   JVM class method access bitmask and values.
JVMMethodAccess: Public == Private where
  Public == Join(SetCategory,Logic) with
    jvmPublic: %
      ++ The method was declared public; therefore mey accessed from
      ++ outside its package.
    jvmPrivate: %
      ++ The method was declared private; threfore can be accessed only
      ++ within the defining class.
    jvmProtected: %
      ++ The method was declared protected; therefore may be accessed
      ++ withing derived classes.
    jvmStatic: %
      ++ The method was declared static.
    jvmFinal: %
      ++ The method was declared final; therefore may not be overriden.
      ++ in derived classes.
    jvmSynchronized: %
      ++ The method was declared synchronized.
    jvmNative: %
      ++ The method was declared native; therefore implemented in a language
      ++ other than Java.
    jvmAbstract: %
      ++ The method was declared abstract; therefore no implementation
      ++ is provided. 
    jvmStrict: %
      ++ The method was declared fpstrict; therefore floating-point mode
      ++ is FP-strict.
  Private == UInt16 add
    jvmPublic == per(16r0001::Rep)
    jvmPrivate == per(16r0002::Rep)
    jvmProtected == per(16r0004::Rep)
    jvmStatic == per(16r0008::Rep)
    jvmFinal == per(16r0010::Rep)
    jvmSynchronized == per(16r0020::Rep)
    jvmNative == per(16r0100::Rep)
    jvmAbstract == per(16r0400::Rep)
    jvmStrict == per(16r0800::Rep)

@

\section{JVM constant pool tags}

<<domain JVMCSTTG JVMConstantTag>>=
)abbrev domain JVMCSTTG JVMConstantTag
++ Date Created: July 18, 2008
++ Data Last Modified: July 18, 2010
++ Description:
++   JVM class file constant pool tags.
JVMConstantTag: Public == Private where
  Public == Join(SetCategory,CoercibleTo Byte) with
    jvmUTF8ConstantTag: %
      ++ The corresponding constant pool entry is sequence of bytes
      ++ representing Java UTF8 string constant.
    jvmIntegerConstantTag: %
      ++ The corresponding constant pool entry is an integer constant info.
    jvmFloatConstantTag: %
      ++ The corresponding constant pool entry is a float constant info.
    jvmLongConstantTag: %
      ++ The corresponding constant pool entry is a long constant info.
    jvmDoubleConstantTag: %
      ++ The corresponding constant pool entry is a double constant info.
    jvmClassConstantTag: %
      ++ The corresponding constant pool entry represents a class or
      ++ and interface.
    jvmStringConstantTag: %
      ++ The corresponding constant pool entry is a string constant info.
    jvmFieldrefConstantTag: %
      ++ The corresponding constant pool entry represents a class field info.
    jvmMethodrefConstantTag: %
      ++ The correspondong constant pool entry represents a class method info.
    jvmInterfaceMethodConstantTag: %
      ++ The correspondong constant pool entry represents an interface
      ++ method info.
    jvmNameAndTypeConstantTag: %
      ++ The correspondong constant pool entry represents the name
      ++ and type of a field or method info.
  Private == Byte add
    jvmUTF8ConstantTag == per byte 1
    jvmIntegerConstantTag == per byte 3
    jvmFloatConstantTag == per byte 4
    jvmLongConstantTag == per byte 5
    jvmDoubleConstantTag == per byte 6
    jvmClassConstantTag == per byte 7
    jvmStringConstantTag == per byte 8
    jvmFieldrefConstantTag == per byte 9
    jvmMethodrefConstantTag == per byte 10
    jvmInterfaceMethodConstantTag == per byte 11
    jvmNameAndTypeConstantTag == per byte 12
@


\section{The JVMBytecode domain}
<<domain JVMBCODE JVMBytecode>>=
)abbrev domain JVMBCODE JVMBytecode
++ Author: Gabriel Dos Reis
++ Date Created: May 08, 2008
++ Data Last Modified: July 18, 2010
++ Description:
++   This is the datatype for the JVM bytecodes.
JVMBytecode: Public == Private where
  Public == Join(SetCategory, HomotopicTo Byte)
  Private == Byte add
    coerce(b: Byte): % ==
      per b

    coerce(x: %): Byte ==
      rep x
@

\section{JVM Opcodes}

<<domain JVMOP JVMOpcode>>=
)abbrev domain JVMOP JVMOpcode
++ Date Created: July 18, 2008
++ Data Last Modified: July 18, 2010
++ Description:
++   This is the datatype for the JVM opcodes.
JVMOpcode: Public == Private where
  Public == Join(SetCategory,HomotopicTo JVMBytecode,HomotopicTo Byte)
  Private == JVMBytecode add
    -- mnemonics equivalent of bytecodes.
    mnemonics : PrimitiveArray Symbol := 
      [['nop, 'aconst__null, 'iconst__m1, 'iconst__0, 'iconst__1,  _
       'iconst__2, 'iconst__3, 'iconst__4, 'iconst__5, 'lconst__0, _
       'lconst__1, 'fconst__0, 'fconst__1, 'fconst__2, 'dconst__0, _
       'dconst__1, 'bipush, 'sipush, 'ldc, ldc__w, 'ldc2__w,       _
       'iload, 'lload, 'fload, 'dload, 'aload, 'iload__0,          _
       'iload__1, 'iload__2, 'iload__3, 'lload_0, 'lload__1,       _
       'lload__2, 'lload__3, 'fload__0, 'fload__1, 'fload__2,      _
       'fload__3, 'dload__0, 'dload__1, 'dload__2, 'dload__3,      _
       'aload__0, 'aload__1, 'aload__2, 'aload__3, 'iaload,        _
       'laload, 'faload, 'daload, 'aaload, 'baload, 'caload,       _
       'saload, 'istore, 'lstore, 'fstore, 'dstore, 'atore,        _
       'istore__0, 'istore__1, 'istore__2, 'istore__3, 'lstore__0, _
       'lstore__1, 'lstore__2, 'lstore__3, 'fstore__0, 'fstore__1, _
       'fstore__2, 'fstore__3, 'dstore__0, 'dstore__1, 'dstore__2, _
       'dstore__3, 'astore__0, 'astore__1, 'astore__2, 'astore__3, _
       'iastore, 'lastore, 'fastore, 'dastore, 'aastore, 'bastore, _
       'castore, 'sastore, 'pop, 'pop2, 'dup, 'dup__x1, 'dup__x2,  _
       'dup2, 'dup2__x1, 'dup2__x2, 'swap, 'iadd, 'ladd, 'fadd,    _
       'dadd, 'isub, 'lsub, 'fsub, 'dsub, 'imul, 'lmul, 'fmul,     _
       'dmul, 'idiv, 'ldiv, 'fdiv, 'ddiv, 'irem, 'lrem, 'frem,     _
       'drem, 'ineg, 'lneg, 'fneg, 'dneg, 'ishl, 'lshl, 'ishr,     _
       'lshr, 'iushr, 'lushr, 'iand, 'land, 'ior, 'lor, 'ixor,     _
       'lxor, 'iinc, 'i2l, 'i2f, 'i2d, 'l2i, 'l2f, 'l2d, 'f2i,     _
       'f2l, 'f2d, 'd2i, 'd2l, 'd2f, 'i2b, 'i2c, 'i2s, 'lcmp,      _
       'fcmpl, 'fcmpg, 'dcmpl, 'dcompg, 'ifeq, 'ifne, 'iflt,       _
       'ifge, 'ifle, 'if__icmpeq, 'if__icmpne, 'if__icmplt,        _
       'if__cmpge, 'if__cmpgt, 'if__cmple, 'if__cmpeq, 'if__acmpeq,_
       'if__acmpne, 'goto, 'jsr, 'ret, 'tableswitch, 'lookupswitch,_
       'ireturn, 'lreturn, 'freturn, 'dreturn, 'areturn, '_return,  _
       'getstatic, 'putstatic, 'getfield,'putfield, 'invokevirtual,_
       'invokespecial, 'invokestatic, 'invokeinterface,            _
       'xxxunusedxxx, 'new, 'newarray, 'anewarray, 'arraylength,   _
       'athrow, 'checkcast, 'instanceof, 'monitorenter,            _
       'monitorexit, 'wide, 'multianewarray, 'ifnull, 'ifnonnull,  _
       'goto__w, 'jsr__w, 'breakpoint, 'unknownopcode0,            _
       'unknownopcode1, 'unknownopcode2, 'unknownopcode3,          _
       'unknownopcode4, 'unknownopcode5, 'unknownopcode6,          _
       'unknownopcode7, 'unknownopcode8, 'unknownopcode9,          _
       'unknownopcode10, 'unknownopcode11, 'unknownopcode12,       _
       'unknownopcode13, 'unknownopcode14, 'unknownopcode15,       _
       'unknownopcode16, 'unknownopcode17, 'unknownopcode18,       _
       'unknownopcode19, 'unknownopcode20, 'unknownopcode21,       _
       'unknownopcode22, 'unknownopcode23, 'unknownopcode24,       _
       'unknownopcode25, 'unknownopcode26, 'unknownopcode27,       _
       'unknownopcode28, 'unknownopcode29, 'unknownopcode30,       _
       'unknownopcode31, 'unknownopcode32, 'unknownopcode33,       _
       'unknownopcode34, 'unknownopcode35, 'unknownopcode36,       _
       'unknownopcode37, 'unknownopcode38, 'unknownopcode39,       _
       'unknownopcode40, 'unknownopcode41, 'unknownopcode42,       _
       'unknownopcode43, 'unknownopcode44, 'unknownopcode45,       _
       'unknownopcode46, 'unknownopcode47, 'unknownopcode48,       _
       'unknownopcode49, 'unknownopcode50,       _
       'impldep1, 'impldep2 ]]$PrimitiveArray(Symbol)

    coerce(x: %): JVMBytecode == rep x
    coerce(b: JVMBytecode): % == per b
    coerce(x: %): OutputForm ==
      mnemonics.(x::Byte::Integer) :: OutputForm

@


\section{License}
<<license>>=
--Copyright (C) 2007-2016, Gabriel Dos Reis.
--All rights reserved.
--
--Redistribution and use in source and binary forms, with or without
--modification, are permitted provided that the following conditions are
--met:
--
--    - Redistributions of source code must retain the above copyright
--      notice, this list of conditions and the following disclaimer.
--
--    - Redistributions in binary form must reproduce the above copyright
--      notice, this list of conditions and the following disclaimer in
--      the documentation and/or other materials provided with the
--      distribution.
--
--    - Neither the name of The Numerical Algorithms Group Ltd. nor the
--      names of its contributors may be used to endorse or promote products
--      derived from this software without specific prior written permission.
--
--THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
--IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
--TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
--PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
--OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
--EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
--PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
--PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
--LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
--NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
--SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
@

<<*>>=
<<license>>

<<domain JVMCFACC JVMClassFileAccess>>
<<domain JVMFDACC JVMFieldAccess>>
<<domain JVMMDACC JVMMethodAccess>>
<<domain JVMCSTTG JVMConstantTag>>
<<domain JVMBCODE JVMBytecode>>
<<domain JVMOP JVMOpcode>>

@

\end{document}