Определенный typeFileURL

Короче говоря typeFileURL Базовая Основа URL, закодированный к потоку байтов в формате UTF-8. Это - предложенный тип данных для использования, когда приложение хотело бы создать ссылку на файл, который должен все же быть создан. Кроме того, существует много других серьезных оснований использовать этот тип; в зависимости от Ваших требований к обработке можно хотеть использовать этот тип данных при многих различных обстоятельствах. Вот некоторые свойства и функции typeFileURL формат данных:

• typeAlias и typeFSRef потребуйте детерминированной ссылки, и не может относиться к файлам, которые должны все же быть созданы. typeFileURL использует слабое, «по имени» разрабатывают ссылку, предоставленную URLs, и как таковой довольно способно к обеспечению предопределенных ссылок на файлы.

• typeFileURL обеспечивает кодирование средств специальных символов в именах каталогов и именах файлов включая '/', ':', и символы Unicode.

• Это - тот же формат данных как 'furl' перетащите разновидность. Эта разновидность присоединена, перетаскивают ссылки, содержащие разновидности HFS. Это используется внутренне менеджером по Перетаскиванию следующим образом:

  • В заявлении отправки: когда разновидность HFS добавляется к элементу перетаскивания, менеджер по Перетаскиванию кодирует a 'furl' разновидность в элементе перетаскивания, ссылающемся на тот же файл.

  • В приложении получения: 'furl' разновидность декодируется и используется для обновления FSSpec поля записи в разновидности HFS, прежде чем это будет передано приложению получения.

  Результат состоит в том, что приложение может использовать разновидности HFS непосредственно, не волнуясь об устаревших Идентификационных номерах каталога ссылочных номеров объема. Но, также, приложение, использующее typeFileURL тип данных может использовать закодированный 'furl' разновидность непосредственно, вместо того, чтобы использовать разновидность HFS.

• URLs, предоставленный Базовой Основой, кодирует информацию о точке монтирования. Также, typeFileURL ссылки способны к различению объемов с тем же именем.

• typeFileURL не кодирует специфичной для процесса информации, такой как ссылочные номера объема или Идентификационные номера каталога. Также, это допустимо для передачи этого формата от процесса до процесса.

• typeFileURL статическая нестойкая ссылка. Т.е. если a typeFileURL создается, который ссылаются файл и что файл позже перемещен, typeFileURL больше не будет ссылаться на тот файл. Для этого типа функциональности необходимо рассмотреть использование typeAlias формат.

Подпрограммы, показанные в Перечислении 1, обеспечивают функциональное определение для typeFileURL формат. Эти подпрограммы могут использоваться для преобразования записей дескриптора события Apple, содержащих typeFileURL данные в Базовую Основу URLs. Базовый URLs Основы самостоятельно обеспечивает ясную ссылку на файлы, которые могут использоваться приложениями.

  Подпрограммы перечисления 1, иллюстрирующие, как закодировать и декодировать, 'сворачивают' записи дескриптора события Apple. Эти подпрограммы обеспечивают функциональное определение для этого типа данных.

 /* encode -> AEDesc
    FURLDescFromCFURL encodes a Core Foundation URL into a
    Apple event descriptor record and returns a pointer to
    the descriptor record. If an error occurs, NULL is
    returned. */
AEDesc * FURLDescFromCFURL(AEDesc *furlDesc, CFURLRef url) {
    CFDataRef theData;
    OSStatus err;
    AEDesc *furlResult;

        /* set up locals to a known state */
    furlResult = NULL;

        /* encode the URL to a UTF8 data string */
    theData = CFURLCreateData(nil, url, kCFStringEncodingUTF8, true);
    if (theData != NULL) {

            /* put the data into the descriptor */
        err = AECreateDesc('furl', CFDataGetBytePtr(theData),
            CFDataGetLength(theData), furlDesc);

            /* if successful, set the result */
        if (err == noErr) {
            furlResult = furlDesc;
        }
            /* release the local buffer */
        CFRelease(theData);
    }
        /* return a pointer to the furl descriptor */
    return furlResult;
}

    /* decode -> CFURL
    FURLDescToCFURL decodes an Apple event descriptor record
    containing a furl descriptor and returns a Core Foundation
    URL. If an error occurs, NULL is returned. */
CFURLRef FURLDescToCFURL(AEDesc *furlDesc) {
    Ptr dataPtr;
    Size bytecount;
    CFURLRef url;
    OSStatus err;

        /* set up locals to a known state */
    url = NULL;

        /* verify the type is correct */
    if (furlDesc->descriptorType == 'furl') {

            /* count the bytes in the descriptor */
        bytecount = AEGetDescDataSize(furlDesc);

            /* allocate a local buffer for the bytes */
        dataPtr = malloc(bytecount);
        if (dataPtr != NULL) {

                /* copy the bytes from the descriptor */
            err = AEGetDescData(furlDesc, dataPtr, bytecount);
            if (err == noErr) {

                    /* create a Core Foundation URL */
                url = CFURLCreateWithBytes(nil, dataPtr, bytecount,
                    kCFStringEncodingUTF8, nil);

            }
                /* deallocate the local buffer */
            free(dataPtr);
        }
    }
        /* return the new URL */
    return url;
}

Это типы данных во время выполнения, используемые приложениями для связи расположения файлов. Также, определение двоичного формата для этого типа не предоставлено в этом документе. Однако разработчики, интересующиеся обнаружением точных подробных данных двоичного кодирования, используемого для этого типа данных, должны консультироваться с Базовой документацией Основы.

Когда использовать typeFileURL

typeFileURL было специально предназначено для разрешения ссылки на файлы, которые должны все же быть созданы. Также, его первичная функция должна позволить именованию файла войти, и ссылка «Сохраняют Как...» события Apple стиля, отправленные между и в приложениях.

В приложении, которое было factored и отправляет события Apple в себя для обработки в ответ на команды пользовательского интерфейса, typeFileURL необходимый механизм кодирования как традиционные схемы кодирования, не достаточные для кодирования ссылок на файлы, которые должны все же быть созданы в Mac OS X.

Создание typeFileURL от ответа Navigation Services

Естественно, первый шаг в процессе, проиллюстрированном на рисунке 1, получает Базовую Основу, URL от Navigation Services отвечает, что ссылаются файл, который должен быть создан. В Mac OS X, запись ответа Navigation Services, возвращенная a NavCreatePutFileDialog/NavDialogRun последовательность будет содержать FSRef обращение к папке, где новый файл должен быть создан в первой записи AEDesc в AEDescList, содержавшемся в NavReplyRecord selection поле и имя нового файла будут содержавшийся в CFString, именуемом saveFileName поле. Перечисление 2 иллюстрирует один способ, которым это может быть сделано.

Перечисление 2  пример того, как можно было генерировать Базовую Основу URL от записи ответа Navigation Services, возвращенной последовательностью NavCreatePutFileDialog/NavDialogRun.

 /* GetCFURLFromNavReply returns a URL referencing a file that
    is yet to be created in response to a
    NavCreatePutFileDialog/NavDialogRun sequence */
CFURLRef GetCFURLFromNavReply(const NavReplyRecord * navReply) {
    OSStatus err;
    FSRef parentFSRef;
    CFURLRef parentURLRef, fullURLRef;
    AEKeyword theAEKeyword;
    DescType typeCode;
    Size actualSize;

        /* ensure locals are in a known state */
    fullURLRef = NULL;

        /* get the FSRef referring to the parent directory */
    err = AEGetNthPtr(&navReply->selection, 1, typeFSRef,
        &theAEKeyword, &typeCode, &parentFSRef, sizeof(FSRef), &actualSize);
    if (err == noErr) {

            /* convert the FSRef into a Core Foundation URL */
        parentURLRef = CFURLCreateFromFSRef(NULL, &parentFSRef);
        if (parentURLRef != NULL) {

                /* add the file name to the end of the url */
            fullURLRef = CFURLCreateCopyAppendingPathComponent(NULL,
                parentURLRef, navReply->saveFileName, false);

                /* release the path to the parent */
            CFRelease(parentURLRef);
        }
    }
        /* return the reference to the new URL */
    return fullURLRef;
}

Как только ссылка на файл была закодирована как CFURL, подпрограмма такой как FURLDescFromCFURL (см. Перечисление 1), может использоваться для кодирования его в запись дескриптора события Apple как 'furl' отформатированный дескриптор. Как только это было преобразовано в этот формат, это готово к транспорту в событии Apple.

На создание файла ссылается typeFileURL

Для декодирования записи дескриптора события Apple, содержащей a typeFileURL Ваше приложение использовало бы метод, подобный тому, представленному в FURLDescToCFURL подпрограмма, показанная в Перечислении 1. Это обеспечит CFURL ссылка на файл, который должен быть создан, который поочередно может использоваться для генерации обоих ссылка на каталог (где файл должен быть создан), и имя файла для создания. Эти элементы могут тогда быть переданы FSCreateFileUnicode, показанный в Перечислении 3, для выполнения работы создания файла. Как только файл был создан, на него можно сослаться с помощью FSRef запись.

Перечисление 3  пример того, как можно было создать файл, на который ссылается CFURL использование подпрограммы FSCreateFileUnicode.

 /* CreateFileUsingCFURL creates the file referenced by
    the CFURL using the supplied catalog parameters. */
OSStatus CreateFileUsingCFURL(
            FSRef *newFileReference,
            CFURLRef url,
            FSCatalogInfoBitmap whichInfo,
            const FSCatalogInfo * catalogInfo) {

    CFURLRef parentURL;
    CFStringRef fileNameRef;
    FSRef parentDirectory;
    UniCharPtr nameStringPtr;
    OSStatus err;

        /* set locals to a known state */
    err = coreFoundationUnknownErr;

        /* get the url to the parent directory */
    parentURL = CFURLCreateCopyDeletingLastPathComponent(NULL, url);
    if (parentURL != NULL) {

            /* convert the URL to a FSRef */
        if (CFURLGetFSRef(parentURL, &parentDirectory)) {

                /* get the leaf name from the URL */
            fileNameRef = CFURLCopyLastPathComponent(url);
            if (fileNameRef != NULL) {

                    /* get the leaf name from the URL */
                nameStringPtr = CFStringGetCharactersPtr(fileNameRef);
                if (nameStringPtr != NULL) {

                        /* create the file */
                    err = FSCreateFileUnicode(
                        &parentDirectory,
                        CFStringGetLength(fileNameRef),
                        nameStringPtr,
                        whichInfo, catalogInfo,
                        newFileReference, NULL);
                }
                    /* release the file name */
                CFRelease(fileNameRef);
            }
        }
            /* release the parent url */
        CFRelease(parentURL);
    }
        /* return the status value */
    return err;
}

Усовершенствованные подпрограммы для использования typeFileURL

Пример кода, представленный в этом документе, был выбран для иллюстрации и был разработан для представления идей. Больше опытных пользователей может хотеть консультироваться со списками примера кода, предоставленными в присоединенном файле загрузки. Эти исходные файлы включают:

• Обработчики приведения события Apple для автоматического преобразования в typeFileURL, typeChar, typeStyledText, typeUnicodeText, cFile, typeFSS, typeFSRef, typeAlias, и typeObjectSpecifier

• Служебные подпрограммы для использования typeFileURL записи в записях события Apple

Загрузки

• Усовершенствованные typeFileURL подпрограммы («tn2022_code.zip», 9.7K)