com.webcodepro.applecommander.storage.os.rdos
Class RdosFormatDisk

java.lang.Object
  com.webcodepro.applecommander.storage.Disk
      com.webcodepro.applecommander.storage.FormattedDisk
          com.webcodepro.applecommander.storage.os.rdos.RdosFormatDisk

All Implemented Interfaces:

DirectoryEntry

public class RdosFormatDisk
extends FormattedDisk

Manages a disk that is in the RDOS format.

Note that the RDOS block interleave is different than the standard DOS 3.3 format. Thus, when the image is made, the sectors are skewed differently - use readRdosBlock to read the appropriate block number.

Also note that the operating system is itself the first file. Block #0 is really track 0, sector 0 - meaning that the first file should not (cannot) be deleted.

RDOS appears to have been placed on 13 sector disks. This limits the number of blocks to 455. It also may also cause incompatibilities with other formats and other cracks.

Date created: Oct 7, 2002 2:03:58 PM

Author:

Rob Greene

Nested Class Summary

Nested classes/interfaces inherited from class com.webcodepro.applecommander.storage.FormattedDisk

FormattedDisk.DiskInformation, FormattedDisk.DiskUsage, FormattedDisk.FileColumnHeader

Nested classes/interfaces inherited from class com.webcodepro.applecommander.storage.Disk

Disk.FilenameFilter

Field Summary

static int	BLOCKS_ON_DISK Specifies the number of blocks on the disk.
static int	ENTRY_LENGTH Specifies the length of a file entry.
static java.lang.String[]	filetypes The known filetypes for a RDOS disk.

Fields inherited from class com.webcodepro.applecommander.storage.FormattedDisk

FILE_DISPLAY_DETAIL, FILE_DISPLAY_NATIVE, FILE_DISPLAY_STANDARD

Fields inherited from class com.webcodepro.applecommander.storage.Disk

APPLE_10MB_HARDDISK, APPLE_140KB_DISK, APPLE_140KB_NIBBLE_DISK, APPLE_20MB_HARDDISK, APPLE_32MB_HARDDISK, APPLE_5MB_HARDDISK, APPLE_800KB_2IMG_DISK, APPLE_800KB_DISK, BLOCK_SIZE, DOS33_SECTORS_ON_140KB_DISK, PRODOS_BLOCKS_ON_140KB_DISK, SECTOR_SIZE

Constructor Summary

RdosFormatDisk(java.lang.String filename, ImageOrder imageOrder)
Constructor for RdosFormatDisk.

Method Summary

boolean	canCreateDirectories() Identify if additional directories can be created.
boolean	canCreateFile() Indicates if this disk image can create a file.
boolean	canDeleteFile() Indicates if this disk image can delete a file.
boolean	canHaveDirectories() RDOS dos not support directories.
boolean	canReadFileData() Indicates if this disk image can read data from a file.
boolean	canWriteFileData() Indicates if this disk image can write data to a file.
void	changeImageOrder(ImageOrder imageOrder) Change to a different ImageOrder.
static RdosFormatDisk[]	create(java.lang.String filename, ImageOrder imageOrder) Create a RdosFormatDisk.
DirectoryEntry	createDirectory() Create a new DirectoryEntry.
FileEntry	createFile() Create a new FileEntry.
void	format() Format the disk as an RDOS disk.
int[]	getBitmapDimensions() Get suggested dimensions for display of bitmap.
java.lang.String[]	getBitmapLabels() Get the labels to use in the bitmap.
int	getBitmapLength() Get the length of the bitmap.
java.util.List	getDiskInformation() Get Pascal-specific disk information.
java.lang.String	getDiskName() RDOS really does not have a disk name.
FormattedDisk.DiskUsage	getDiskUsage() Get the disk usage iterator.
java.util.List	getFileColumnHeaders(int displayMode) Get the standard file column header information.
byte[]	getFileData(FileEntry fileEntry) Get the data associated with the specified FileEntry.
java.util.List	getFiles() Retrieve a list of files.
java.lang.String[]	getFiletypes() Returns a list of possible file types.
java.lang.String	getFormat() Identify the operating system format of this disk.
int	getFreeBlocks() Return the number of free blocks.
int	getFreeSpace() Return the amount of free space in bytes.
int	getLogicalDiskNumber() Returns the logical disk number.
java.lang.String	getSuggestedFilename(java.lang.String filename) Returns a valid filename for the given filename.
java.lang.String	getSuggestedFiletype(java.lang.String filename) Returns a valid filetype for the given filename.
int	getUsedBlocks() Return the number of used blocks.
int	getUsedSpace() Return the amount of used space in bytes.
boolean	needsAddress(java.lang.String filetype) Indicates if this filetype requires an address component.
byte[]	readRdosBlock(int block) Read an RDOS block.
void	setFileData(FileEntry fileEntry, byte[] fileData) Writes the raw bytes into the file.
boolean	supportsDeletedFiles() Indicates if this disk format supports "deleted" files.
boolean	supportsDiskMap() Indicates if this FormattedDisk supports a disk map.
void	writeRdosBlock(int block, byte[] data) Write an RDOS block.

Methods inherited from class com.webcodepro.applecommander.storage.FormattedDisk

getFile, getFile, getFormattedDisk, resizeDiskImage, writeBootCode

Methods inherited from class com.webcodepro.applecommander.storage.Disk

getDiskImageManager, getFilename, getFilenameFilters, getFormattedDisks, getImageOrder, getPhysicalSize, hasChanged, is140KbDisk, is2ImgOrder, is800KbDisk, isCompressed, isCpmFormat, isDosFormat, isDosOrder, isNewImage, isNibbleOrder, isOzDosFormat, isPascalFormat, isProdosFormat, isProdosOrder, isRdosFormat, isUniDosFormat, readBlock, readSector, resizeDiskImage, save, saveAs, setFilename, setImageOrder, writeBlock, writeSector

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ENTRY_LENGTH

public static final int ENTRY_LENGTH

Specifies the length of a file entry.

See Also:

Constant Field Values

BLOCKS_ON_DISK

public static final int BLOCKS_ON_DISK

Specifies the number of blocks on the disk. RDOS apparantly only worked on 5.25" disks.

See Also:

Constant Field Values

filetypes

public static final java.lang.String[] filetypes

The known filetypes for a RDOS disk.

Constructor Detail

RdosFormatDisk

public RdosFormatDisk(java.lang.String filename,
                      ImageOrder imageOrder)

Constructor for RdosFormatDisk.

Method Detail

create

public static RdosFormatDisk[] create(java.lang.String filename,
                                      ImageOrder imageOrder)

Create a RdosFormatDisk.

readRdosBlock

public byte[] readRdosBlock(int block)

Read an RDOS block. The sector skewing for RDOS seems to be different. This routine will convert the block number to a DOS track and sector, handling the sector change-over. The readSector method then should take care of various image formats.

Note that sectorSkew has the full 16 sectors, even though RDOS itself is a 13 sector format.

writeRdosBlock

public void writeRdosBlock(int block,
                           byte[] data)

Write an RDOS block. The sector skewing for RDOS seems to be different. This routine will convert the block number to a DOS track and sector, handling the sector change-over. The writeSector method then should take care of various image formats.

Note that sectorSkew has the full 16 sectors, even though RDOS itself is a 13 sector format.

getDiskName

public java.lang.String getDiskName()

RDOS really does not have a disk name. Fake one.

Specified by:

getDiskName in class FormattedDisk

getFiles

public java.util.List getFiles()

Retrieve a list of files.

createFile

public FileEntry createFile()
                     throws DiskFullException

Create a new FileEntry.

Throws:

DiskFullException

canCreateDirectories

public boolean canCreateDirectories()

Identify if additional directories can be created. This may indicate that directories are not available to this operating system or simply that the disk image is "locked" to writing.

canCreateFile

public boolean canCreateFile()

Indicates if this disk image can create a file. If not, the reason may be as simple as it has not beem implemented to something specific about the disk.

getFormat

public java.lang.String getFormat()

Identify the operating system format of this disk.

Specified by:

getFormat in class FormattedDisk

getFreeBlocks

public int getFreeBlocks()

Return the number of free blocks.

getUsedBlocks

public int getUsedBlocks()

Return the number of used blocks.

getFreeSpace

public int getFreeSpace()

Return the amount of free space in bytes.

Specified by:

getFreeSpace in class FormattedDisk

getUsedSpace

public int getUsedSpace()

Return the amount of used space in bytes.

Specified by:

getUsedSpace in class FormattedDisk

getBitmapDimensions

public int[] getBitmapDimensions()

Get suggested dimensions for display of bitmap. Since RDOS uses blocks, a null is returned indicating no suggsetions.

Specified by:

getBitmapDimensions in class FormattedDisk

getBitmapLength

public int getBitmapLength()

Get the length of the bitmap.

Specified by:

getBitmapLength in class FormattedDisk

getDiskUsage

public FormattedDisk.DiskUsage getDiskUsage()

Get the disk usage iterator.

Specified by:

getDiskUsage in class FormattedDisk

getBitmapLabels

public java.lang.String[] getBitmapLabels()

Get the labels to use in the bitmap.

Specified by:

getBitmapLabels in class FormattedDisk

getDiskInformation

public java.util.List getDiskInformation()

Get Pascal-specific disk information.

Overrides:

getDiskInformation in class FormattedDisk

getFileColumnHeaders

public java.util.List getFileColumnHeaders(int displayMode)

Get the standard file column header information. This default implementation is intended only for standard mode.

Overrides:

getFileColumnHeaders in class FormattedDisk

supportsDeletedFiles

public boolean supportsDeletedFiles()

Indicates if this disk format supports "deleted" files.

Specified by:

supportsDeletedFiles in class FormattedDisk

canReadFileData

public boolean canReadFileData()

Indicates if this disk image can read data from a file.

Specified by:

canReadFileData in class FormattedDisk

canWriteFileData

public boolean canWriteFileData()

Indicates if this disk image can write data to a file.

Specified by:

canWriteFileData in class FormattedDisk

canHaveDirectories

public boolean canHaveDirectories()

RDOS dos not support directories.

Specified by:

canHaveDirectories in class FormattedDisk

canDeleteFile

public boolean canDeleteFile()

Indicates if this disk image can delete a file.

Specified by:

canDeleteFile in class FormattedDisk

getFileData

public byte[] getFileData(FileEntry fileEntry)

Get the data associated with the specified FileEntry.

Specified by:

getFileData in class FormattedDisk

See Also:

FileEntry.getFileData()

format

public void format()

Format the disk as an RDOS disk. FIXME - RDOS does not "like" an AppleCommander formatted disk. This appears to be because the &CAT command reads from track 1 sector 9 (whatever RDOS block that would be) and executes that code for the directory. AppleCommander will need to either clone the code or write its own routine. This is RDOS block #25.

Specified by:

format in class FormattedDisk

See Also:

FormattedDisk.format()

getLogicalDiskNumber

public int getLogicalDiskNumber()

Returns the logical disk number. Returns a 0 to indicate no numbering.

Specified by:

getLogicalDiskNumber in class FormattedDisk

getSuggestedFilename

public java.lang.String getSuggestedFilename(java.lang.String filename)

Returns a valid filename for the given filename. RDOS pretty much allows anything - so it is cut to 24 characters and trimmed (trailing whitespace may cause confusion).

Specified by:

getSuggestedFilename in class FormattedDisk

getSuggestedFiletype

public java.lang.String getSuggestedFiletype(java.lang.String filename)

Returns a valid filetype for the given filename. The most simple format will just assume a filetype of binary. This method is available for the interface to make an intelligent first guess as to the filetype.

Specified by:

getSuggestedFiletype in class FormattedDisk

getFiletypes

public java.lang.String[] getFiletypes()

Returns a list of possible file types. Since the filetype is specific to each operating system, a simple String is used.

Specified by:

getFiletypes in class FormattedDisk

needsAddress

public boolean needsAddress(java.lang.String filetype)

Indicates if this filetype requires an address component. Presumably, the "B" filetype is binary and will need an address.

Specified by:

needsAddress in class FormattedDisk

supportsDiskMap

public boolean supportsDiskMap()

Indicates if this FormattedDisk supports a disk map.

Overrides:

supportsDiskMap in class FormattedDisk

changeImageOrder

public void changeImageOrder(ImageOrder imageOrder)

Change to a different ImageOrder. Remains in RDOS format but the underlying order can chage.

Specified by:

changeImageOrder in class FormattedDisk

See Also:

ImageOrder

setFileData

public void setFileData(FileEntry fileEntry,
                        byte[] fileData)
                 throws DiskFullException

Writes the raw bytes into the file. This bypasses any special formatting of the data (such as prepending the data with a length and/or an address). Typically, the FileEntry.setFileData method should be used.

Specified by:

setFileData in class FormattedDisk

Throws:

DiskFullException

createDirectory

public DirectoryEntry createDirectory()
                               throws DiskFullException

Create a new DirectoryEntry.

Throws:

DiskFullException

See Also:

DirectoryEntry.createDirectory()