home *** CD-ROM | disk | FTP | other *** search
/ Tools / WinSN5.0Ver.iso / NETSCAP.50 / WIN1998.ZIP / ns / lib / libmime / mimepbuf.c < prev    next >
Encoding:
C/C++ Source or Header  |  1998-04-08  |  7.8 KB  |  292 lines
  1. /* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
  2.  *
  3.  * The contents of this file are subject to the Netscape Public License
  4.  * Version 1.0 (the "NPL"); you may not use this file except in
  5.  * compliance with the NPL.  You may obtain a copy of the NPL at
  6.  * http://www.mozilla.org/NPL/
  7.  *
  8.  * Software distributed under the NPL is distributed on an "AS IS" basis,
  9.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
  10.  * for the specific language governing rights and limitations under the
  11.  * NPL.
  12.  *
  13.  * The Initial Developer of this code under the NPL is Netscape
  14.  * Communications Corporation.  Portions created by Netscape are
  15.  * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
  16.  * Reserved.
  17.  */
  18.  
  19. /* mimepbuf.c --- utilities for buffering a MIME part for later display.
  20.    Created: Jamie Zawinski <jwz@netscape.com>, 24-Sep-96.
  21.  */
  22.  
  23. #include "mimepbuf.h"
  24. #include "xp_file.h"
  25.  
  26. /* See mimepbuf.h for a description of the mission of this file.
  27.  
  28.    Implementation:
  29.  
  30.      When asked to buffer an object, we first try to malloc() a buffer to
  31.      hold the upcoming part.  First we try to allocate a 50k buffer, and
  32.      then back off by 5k until we are able to complete the allocation,
  33.      or are unable to allocate anything.
  34.  
  35.      As data is handed to us, we store it in the memory buffer, until the
  36.      size of the memory buffer is exceeded (including the case where no
  37.      memory buffer was able to be allocated at all.)
  38.  
  39.      Once we've filled the memory buffer, we open a temp file on disk.
  40.      Anything that is currently in the memory buffer is then flushed out
  41.      to the disk file (and the memory buffer is discarded.)  Subsequent
  42.      data that is passed in is appended to the file.
  43.  
  44.      Thus only one of the memory buffer or the disk buffer ever exist at
  45.      the same time; and small parts tend to live completely in memory
  46.      while large parts tend to live on disk.
  47.  
  48.      When we are asked to read the data back out of the buffer, we call
  49.      the provided read-function with either: the contents of the memory
  50.      buffer; or blocks read from the disk file.
  51.  */
  52.  
  53. extern int MK_UNABLE_TO_OPEN_TMP_FILE;
  54.  
  55. #define TARGET_MEMORY_BUFFER_SIZE    (1024 * 50)  /* try for 50k mem buffer */
  56. #define TARGET_MEMORY_BUFFER_QUANTUM (1024 * 5)   /* decrease in steps of 5k */
  57. #define DISK_BUFFER_SIZE             (1024 * 10)  /* read disk in 10k chunks */
  58.  
  59.  
  60. struct MimePartBufferData
  61. {
  62.   char *part_buffer;                /* Buffer used for part-lookahead. */
  63.   int32 part_buffer_fp;                /* Active length. */
  64.   int32 part_buffer_size;            /* How big it is. */
  65.  
  66.   char *file_buffer_name;            /* The name of a temp file used when we
  67.                                        run out of room in the part_buffer. */
  68.   XP_File file_stream;                /* A stream to it. */
  69. };
  70.  
  71. MimePartBufferData *
  72. MimePartBufferCreate (void)
  73. {
  74.   MimePartBufferData *data = XP_NEW(MimePartBufferData);
  75.   if (!data) return 0;
  76.   XP_MEMSET(data, 0, sizeof(*data));
  77.   return data;
  78. }
  79.  
  80.  
  81. void
  82. MimePartBufferClose (MimePartBufferData *data)
  83. {
  84.   XP_ASSERT(data);
  85.   if (!data) return;
  86.  
  87.   if (data->file_stream)
  88.     {
  89.       XP_FileClose(data->file_stream);
  90.       data->file_stream = 0;
  91.     }
  92. }
  93.  
  94.  
  95. void
  96. MimePartBufferReset (MimePartBufferData *data)
  97. {
  98.   XP_ASSERT(data);
  99.   if (!data) return;
  100.  
  101.   FREEIF(data->part_buffer);
  102.   data->part_buffer_fp = 0;
  103.  
  104.   if (data->file_stream)
  105.     {
  106.       XP_FileClose(data->file_stream);
  107.       data->file_stream = 0;
  108.     }
  109.   if (data->file_buffer_name)
  110.     {
  111.       XP_FileRemove(data->file_buffer_name, xpTemporary);
  112.       XP_FREE(data->file_buffer_name);
  113.       data->file_buffer_name = 0;
  114.     }
  115. }
  116.  
  117.  
  118. void
  119. MimePartBufferDestroy (MimePartBufferData *data)
  120. {
  121.   XP_ASSERT(data);
  122.   if (!data) return;
  123.   MimePartBufferReset (data);
  124.   XP_FREE(data);
  125. }
  126.  
  127.  
  128. int
  129. MimePartBufferWrite (MimePartBufferData *data,
  130.                      const char *buf, int32 size)
  131. {
  132.   int status = 0;
  133.  
  134.   XP_ASSERT(data && buf && size > 0);
  135.   if (!data || !buf || size <= 0)
  136.     return -1;
  137.  
  138.   /* If we don't yet have a buffer (either memory or file) try and make a
  139.      memory buffer.
  140.    */
  141.   if (!data->part_buffer &&
  142.       !data->file_buffer_name)
  143.     {
  144.       int target_size = TARGET_MEMORY_BUFFER_SIZE;
  145.       while (target_size > 0)
  146.         {
  147.           data->part_buffer = (char *) XP_ALLOC(target_size);
  148.           if (data->part_buffer) break;                    /* got it! */
  149.           target_size -= TARGET_MEMORY_BUFFER_QUANTUM;    /* decrease it and try
  150.                                                            again */
  151.         }
  152.  
  153.       if (data->part_buffer)
  154.         data->part_buffer_size = target_size;
  155.       else
  156.         data->part_buffer_size = 0;
  157.  
  158.       data->part_buffer_fp = 0;
  159.     }
  160.  
  161.   /* Ok, if at this point we still don't have either kind of buffer, try and
  162.      make a file buffer. */
  163.   if (!data->part_buffer &&
  164.       !data->file_buffer_name)
  165.     {
  166.       data->file_buffer_name = WH_TempName(xpTemporary, "nsma");
  167.       if (!data->file_buffer_name) return MK_OUT_OF_MEMORY;
  168.  
  169.       data->file_stream = XP_FileOpen(data->file_buffer_name, xpTemporary,
  170.                                       XP_FILE_WRITE_BIN);
  171.       if (!data->file_stream)
  172.         return MK_UNABLE_TO_OPEN_TMP_FILE;
  173.     }
  174.   
  175.   XP_ASSERT(data->part_buffer || data->file_stream);
  176.  
  177.  
  178.   /* If this buf will fit in the memory buffer, put it there.
  179.    */
  180.   if (data->part_buffer &&
  181.       data->part_buffer_fp + size < data->part_buffer_size)
  182.     {
  183.       XP_MEMCPY(data->part_buffer + data->part_buffer_fp,
  184.                 buf, size);
  185.       data->part_buffer_fp += size;
  186.     }
  187.  
  188.   /* Otherwise it won't fit; write it to the file instead. */
  189.   else
  190.     {
  191.       /* If the file isn't open yet, open it, and dump the memory buffer
  192.          to it. */
  193.       if (!data->file_stream)
  194.         {
  195.           if (!data->file_buffer_name)
  196.             data->file_buffer_name =
  197.               WH_TempName (xpTemporary, "nsma");
  198.           if (!data->file_buffer_name) return MK_OUT_OF_MEMORY;
  199.  
  200.           data->file_stream = XP_FileOpen(data->file_buffer_name, xpTemporary,
  201.                                           XP_FILE_WRITE_BIN);
  202.           if (!data->file_stream)
  203.             return MK_UNABLE_TO_OPEN_TMP_FILE;
  204.  
  205.           if (data->part_buffer && data->part_buffer_fp)
  206.             {
  207.               status = XP_FileWrite (data->part_buffer,
  208.                                      data->part_buffer_fp,
  209.                                      data->file_stream);
  210.               if (status < 0) return status;
  211.             }
  212.  
  213.           FREEIF(data->part_buffer);
  214.           data->part_buffer_fp = 0;
  215.           data->part_buffer_size = 0;
  216.         }
  217.  
  218.       /* Dump this buf to the file. */
  219.       status = XP_FileWrite (buf, size, data->file_stream);
  220.       if (status < 0) return status;
  221.     }
  222.  
  223.   return 0;
  224. }
  225.  
  226.  
  227. int
  228. MimePartBufferRead (MimePartBufferData *data,
  229.                     int (*read_fn) (char *buf, int32 size, void *closure),
  230.                     void *closure)
  231. {
  232.   int status = 0;
  233.   XP_ASSERT(data);
  234.   if (!data) return -1;
  235.  
  236.   if (data->part_buffer)
  237.     {
  238.       /* Read it out of memory.
  239.        */
  240.       XP_ASSERT(!data->file_buffer_name && !data->file_stream);
  241.  
  242.       status = read_fn(data->part_buffer, data->part_buffer_fp, closure);
  243.     }
  244.   else if (data->file_buffer_name)
  245.     {
  246.       /* Read it off disk.
  247.        */
  248.       char *buf;
  249.       int32 buf_size = DISK_BUFFER_SIZE;
  250.  
  251.       XP_ASSERT(data->part_buffer_size == 0 && data->part_buffer_fp == 0);
  252.       XP_ASSERT(!data->file_stream);
  253.       XP_ASSERT(data->file_buffer_name);
  254.       if (!data->file_buffer_name) return -1;
  255.  
  256.       buf = (char *) XP_ALLOC(buf_size);
  257.       if (!buf) return MK_OUT_OF_MEMORY;
  258.  
  259.       if (data->file_stream)
  260.         XP_FileClose(data->file_stream);
  261.       data->file_stream = XP_FileOpen(data->file_buffer_name, xpTemporary,
  262.                                       XP_FILE_READ_BIN);
  263.       if (!data->file_stream)
  264.         {
  265.           XP_FREE(buf);
  266.           return MK_UNABLE_TO_OPEN_TMP_FILE;
  267.         }
  268.  
  269.       while(1)
  270.         {
  271.           int32 rstatus = XP_FileRead(buf, buf_size - 1, data->file_stream);
  272.           if (rstatus <= 0)
  273.             {
  274.               status = rstatus;
  275.               break;
  276.             }
  277.           else
  278.             {
  279.               /* It would be really nice to be able to yield here, and let
  280.                  some user events and other input sources get processed.
  281.                  Oh well. */
  282.  
  283.               status = read_fn (buf, rstatus, closure);
  284.               if (status < 0) break;
  285.             }
  286.         }
  287.       XP_FREE(buf);
  288.     }
  289.  
  290.   return 0;
  291. }
  292.