К. Арнольд, Д. Гослинг - Язык программирования Java (1160779), страница 25
Текст из файла (страница 25)
Заголовочный файл <<javaString.h>> определяет несколько функций,помогающих в решении этой задачи. Все функции, преобразующие объекты String языка Java в строки C, переносят в них только младшие 8 битсимволов Unicode. Эти функции работают с дескрипторами, которые передаются родным методам, хранятся в структурах языка C или создаютсяс помощью приведенных ниже функций.char *allocCString(Hjava_lang_String *str)Вызывает функцию malloc языка C для создания буфера, размер которого достаточен для хранения строки.
Когда вы закончитеработать со строкой, не забудьте вызвать free для возвращенного указателя.char *javaString2CString(Hjava_lang_String *str, char buffer[], int length)Копирует до length символов из str в buffer. Размещение и освобождение буфера лежит на совести программиста. Для удобствафункция возвращает buffer.char *makeCString(Hjava_lang_String *str)Возвращает строку языка C, которая может быть уничтожена сборщиком мусора. Сборщик мусора в поисках ссылок сканирует нетолько объекты Java, но и данные C, поэтому строка не может быть уничтожена им в случае, если указатель на нее используется вродном методе.int javaStringLength(Hjava_lang_String *str)Возвращает длину строки Java.
Функции передается параметр-дескриптор.unicode *javaString2unicode(Hjava_lang_String *str, unicode *buf, int len)Копирует до len символов Unicode из str в буфер buf. Тип данных unicode определяется при включении файла <<native.h>> ипредставляет собой 16-разрядное символьное значение.Для создания новых объектов используется функция makeJavaString:Hjava_lang_String *makeJavaString(char *str, int len)Возвращает дескриптор нового строкового объекта, созданного на основе строки str языка C, с использованием начальных lenбайтов строки. Длина не должна учитывать нуль-байт, завершающий строку в языке C.Если какой-либо из этих методов столкнется с ошибкой (например, нехваткой памяти), он вызывает SignalError с соответствующим исключением ивозвращает NULL.
В этом случае необходимо выполнить нужные завершающие действия и выйти из функции.Ниже показано, как можно написать родной метод с использованием функции strxfrm, соответствующей стандарту ANSI C, которая по обычной 8разрядной строке стандарта Latin-1 создает порядковую строку, соответствующую локальному языковому контексту. Созданная строка можетиспользоваться для сравнения исходной строки с другими строками. Локальный языковой контекст определяет порядок сортировки принятыйво французском языке, норвежском, испанском и т.
д. Сортировка строк с помощью функции strxfrm выполняется следующим образом:1. Вызовите strxfrm для двух строк, чтобы создать для каждой из них порядковую строку.1. Сравните порядковые строки функцией strcmp, которая возвращает отрицательное, равное нулю или положительное число, если перваястрока соответственно меньше, равна или больше второй.1.
Упорядочите исходные строки в зависимости от результатов вызова strcmp для двух порядковых строк.Эта процедура может пригодиться, если вашей программе часто приходится сортировать строки в соответствии с локальным языковымпорядком. Другая возможность заключается в том, чтобы применить strcoll вместо strcmp. Вызов функции strcoll обходится дороже, чемобращение к strcmp, но он не требует хранения порядковых строк для их последующего использования.Приведем пример класса, который содержит вспомогательные методы, учитывающие особенности языков при работе со строками:package local;public class LocalString {/** возвращает порядковую строку для str */public native static String xfrm(String str);/** сортирует массив в соответствии с локальным контекстом */public native static String[] sort(String[] input);static {System.loadLibrary("LocalString");}}Метод sort мы рассмотрим в следующем разделе.Вот один из способов реализации xfrm:HString *local_LocalString_xfrm(struct Hlocal_LocalString *this_h,Hjava_lang_String *str_h){Hjava_lang_String *retval;char *str, *xfrm;size_t xfrm_len;set_locale();str = allocString(str_h);if (str == Null)return NULL; /* функция allocString() вызвала SignalError */xfrm_len = strxfrm(Null, str, 0);if ((xfrm = (char *)malloc(xfrm_len + 1)) == NULL) {SignalError(EE(),"java/lang/OutOfMemorytException", NULL);return NULL;}strxfrm(xfrm, str, xfrm_len);retval = makeJavaString(xfrm, xfrm_len);free(xfrm);free(str);return retval;}Первое, что мы должны сделать - это настроить локальный контекст функцией set_locale:#include <<locale.l>>voidset_locale(){static int done_set = 0;if (!done_set) {setlocale(LC_COLLATE, "");done_set++;}}Функция setlocale устанавливает алгоритм сравнения строк для локального контекста, заданного переменными среды, на что указывает параметр"".
После выхода из set_locale мы выделяем место под новую строку языка C, содержимое которой совпадает с содержимым передаваемогопараметра, и проверяем возможные ошибки. Далее мы используем вариант функции strxfrm, который возвращает количество символов дляпорядковой строки, выделяем буфер, рассчитанный на данное количество символов плюс один символ для нуль-байта, и заполняем буферфункцией strxfrm. Затем мы вызываем makeJavaString, чтобы создать новый объект String, содержащий порядковую строку. Перед тем, каквозвращать ее, необходимо освободить выделенную память. Наконец, мы возвращаем объект String, содержащий порядковую строку.Ничто не может помешать программе на C модифицировать символы в структуре Classjava_lang_String, соответствующей объекту String языкаJava. Тем не менее, это нарушает гарантию того, что объекты String доступны только для чтения, на которую часто полагаются runtime-системаJava, сгенерированный программный код и классы.
Например, два объекта String с одинаковым содержимым часто могут совместноиспользовать одну и ту же область памяти. Модификация одного объекта String не только нарушает гарантию — она может привести кодновременной модификации других объектов String.Упражнение А.3Напишите родной метод, который выводит содержимое объекта String.Упражнение А.4Напишите родной метод, который возвращает системную строку, недоступную классам Java — например, имя текущего рабочего каталога илипапки.Упражнение А.5Напишите класс, который использует родные методы для того, чтобы предоставить программам на Java доступ к какой-нибудь библиотеке вашейсистемы.А.5 МассивыМассивы в Java являются типизированными — они могут состоять из значений примитивного типа (массив int) или из объектов класса. Типмассива Java учитывается при его переводе в C.
Существуют специальные типы массивов для примитивных значений и универсальный тип длямассивов, содержащих объекты. Каждый массив в языке C представлен структурой следующего вида:typedef struct {CType *body;} ArrayOfJavaType;В каждой структуре имеется поле с именем body, указывающее на элементы массива; CType — тип языка C, которому соответствует тип элементовмассива, а JavaType — имя типа в языке Java. В таблице показано, как происходит перевод различных массивов из Java в C:Тип массива вJavaТипbodyИмяструктурыТип размещаемого массива вCbooleanArrayOfIntlongT_BOOLEANbyteArrayOfBytecharT_BYTEshortArrayOfShortshortT_SHORTintArrayOfIntlongT_INTlongArrayOfLongint64_tT_LONGfloatArrayOfFloatfloatT_FLOATdoubleArrayOfDoubledoubleT_DOUBLEcharArrayOfCharunicodeT_CHARObjectArrayOfObjectHobjectT_CLASSДоступ к элементам массива осуществляется стандартным образом, в виде body[i]; максимальный индекс на единицу меньше количестваэлементов в массиве.
Функция obj_Length возвращает количество элементов в заданном массиве.Для создания массива используется функция ArrayAlloc:Handle *ArrayAlloc(int type, int size)Создает новый массив заданного типа type, который должен быть одним из типов в приведенной выше таблице. Если параметрtype равен T_CLASS, создается один дополнительный элемент, указывающий на объект класса, соответствующего типу элементовмассива.Приведем в качестве примера функцию, которая создает массив объектов заданного типа:HArrayOfObject *alloc_class_array(char *type,int cnt){HArrayOfObject *retval;}retval = (HArrayOfObject *)ArrayAlloc(T_CLASS, cnt);if (retval == NULL) {SignalError(EE(),"java/lang/OutOfMemorytException", NULL);return NULL;}unhand(retval)->>body[cnt] =(HObject *)FindClass(EE(), type, TRUE);return retval;Сначала мы пытаемся создать массив типа T_CLASS и проверяем, удалось ли нам это.