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
|
/* ObjcRuntimeUtilities.h - Utilities to add classes and methods
in the Objective-C runtime, at runtime.
Copyright (C) 2000 Free Software Foundation, Inc.
Written by: Nicola Pero <nicola@brainstorm.co.uk>
Date: June 2000
This file is part of the GNUstep Java Interface Library.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
*/
/* FIXME: This should be something like a simple #ifndef
__NEXT_RUNTIME__, but __NEXT_RUNTIME__ isn't defined in C code. */
#if !defined(__NEXT_RUNTIME__) && !defined(__APPLE__)
#ifndef __ObjcRuntimeUtilities_h_GNUSTEP_JAVA_INCLUDE
#define __ObjcRuntimeUtilities_h_GNUSTEP_JAVA_INCLUDE
#include <objc/objc-api.h>
#include <objc/thr.h>
#include <objc/encoding.h>
/*
* This code is by no means tidied to Java.
* It provides facilities to programmatically add classes and methods
* to the objc runtime, while the runtime is already running.
* It could be reused for building interfaces to other languages.
* At present this code only works with the GNU Objective-C Runtime,
* because we need to access the runtime internal structures to add
* classes and methods.
*/
/*
Creating a new class
*/
/*
* ObjcUtilities_new_class:
*
* Create a new Objective-C class called name, inheriting from
* superClass.
* If ivarNumber is zero, the new class has not any more instance
* variables than the class it inherits from.
* Otherwise, appropriate optional arguments should be provided; they
* should come in couples; the first one is the ivar name, the second
* one the ivar type. For example:
* ObjcUtilities_new_class ("MyNiceClass", "NSObject", 2,
* "aJavaObject", @encode (jobject),
* "tag", @encode (int));
* creates a class as it would be created by
*
* @interface MyNiceClass : NSObject
* {
* jobject aJavaObject;
* int tag;
* }
* @end
* Return NO upon failure (because the class already exists or the
* superclass does not exist), and YES upon success.
*/
BOOL ObjcUtilities_new_class (const char *name, const char *superclassName,
int ivarNumber, ...);
/*
Adding new methods to a class
Quick HOWTO:
A. alloc a MethodList using ObjcUtilities_alloc_method_list.
B. insert the methods you want to register in the MethodList using
ObjcUtilities_insert_method_in_list.
To get the objective-C runtime type for a method, you may want to use
ObjcUtilities_build_runtime_Objc_signature
C. register your method list with the objective-C runtime using
ObjcUtilities_register_method_list.
*/
/*
* ObjcUtilities_alloc_method_list:
*
* Allocate a MethodList capable of containing `count' methods.
* A pointer to the allocated list is returned.
*
*/
MethodList *ObjcUtilities_alloc_method_list (int count);
/*
* ObjcUtilities_insert_method_in_list:
*
* Insert a method definition in a MethodList. `ml' is a pointer to
* the MethodList. `index' is the index of the method to add. `name'
* is the name of the method; `types' is the objective-C run-time
* signature of the method (see below for a facility to create this
* automatically), `imp' is the IMP (ie, the actual implementation of
* the method). `imp' must be a pointer to a function taking the
* correct arguments and returning the correct type; cast it to an IMP
* then before calling this function.
*/
void ObjcUtilities_insert_method_in_list (MethodList *ml,
int index, const char *name,
const char *types, IMP imp);
/*
* ObjcUtilities_build_runtime_Objc_signature:
*
* This method creates a runtime objc signature which can be used
* to describe type for a selector *on this machine* (you need this
* signature for example to insert a method description in a method list,
* using the ObjcUtilities_insert_method_in_list function above).
*
* It takes as argument a 'naive' objc signature, in the form of
* a string obtained by concatenating the following strings:
*
* @encode(return_type)
*
* @encode(Class) if it's a class method, or @encode(id) if it's an
* instance method (corresponding to the first hidden argument, self)
*
* @encode(SEL) (corresponding to the second hidden argument, the selector)
*
* @encode(arg1) @encode(arg2) ... if there are any real arguments.
*
* An example is:
* "i@:@" for an instance method returning int and taking an object arg.
* (NB: "i" = @encode(int), "@" = @encode(id), ":" = @encode(SEL)).
*
* On my machine, ObjcUtilities_build_runtime_Objc_signature ("i@:@")
* returns "i12@0:4@8", which I can then use as selector type when
* creating entries in MethodList.
*
*/
const char *ObjcUtilities_build_runtime_Objc_signature (const char *);
/*
* ObjcUtilities_register_method_list:
*
* Add the list `ml' of methods to an existing Class `class'.
* They are registered as instance methods.
* To add class methods, you simply need to pass the meta class
* [(Class)class->class_pointer] instead of the class.
*
* *Never* release or modify a method list after registering it with
* *the objective-C runtime.
*/
void ObjcUtilities_register_method_list (Class class, MethodList *ml);
#endif /* __ObjcRuntimeUtilitis_h_GNUSTEP_JAVA_INCLUDE */
#endif
|
