Class: FindFileApplication

• Inheritance
• Description
• Class protocol
  • defaults
  • help specs
  • history
  • instance creation
  • interface specs
  • menu specs
  • startup & release
  • tableColumns specs
• Instance protocol
  • actions
  • actions-CVS
  • aspects
  • change & update
  • private
  • private - searching
  • queries
  • startup & release
• Examples

Inheritance:

   Object
   |
   +--Model
      |
      +--ApplicationModel
         |
         +--AbstractFileApplicationNoteBookComponent
            |
            +--AbstractFileFinderApplicationComponent
               |
               +--FindFileApplication

Package:

stx:libtool

Category:

Interface-Tools-File

Version:

rev: 1.163 date: 2024/04/22 17:39:54

user: stefan

file: FindFileApplication.st directory: libtool

module: stx stc-classLibrary: libtool

Description:

documentation to be added.

class:
    <a short class summary here, describing what instances represent>

responsibilities:    
    <describing what my main role is>

collaborators:    
    <describing with whom and how I talk to>

API:
    <public api and main messages>
    
example:
    <a one-line examples on how to use - can also be in a separate example method>

implementation:
    <implementation points>


[instance variables:]

[class variables:]

copyright
COPYRIGHT (c) 2002 by eXept Software AG
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice.   This software may not
be provided or otherwise made available to, or used by, any
other person.  No title to or ownership of the software is
hereby transferred.

Class protocol:

 tabStringFor: aApplicationType

the formatString shown in a tab (language translated)

 helpSpec

This resource specification was automatically generated
by the UIHelpTool of ST/X.

 addToSearchStringHistory: aString

 searchStringHistory

 open

self open

 openInDirectory: aFilename

self openInDirectory:'/etc'

 openOnFileName: aFileName

 openOnFileName: aFileName for: aTargetApplicationOrNil

 windowSpec

This resource specification was automatically generated
by the UIPainter of ST/X.

Usage example(s):

UIPainter new openOnClass:FindFileApplication andSelector:#windowSpec FindFileApplication new openInterface:#windowSpec FindFileApplication open

 menu

This resource specification was automatically generated
by the MenuEditor of ST/X.

Usage example(s):

MenuEditor new openOnClass:FindFileApplication andSelector:#menu (Menu new fromLiteralArrayEncoding:(FindFileApplication menu)) startUp

 searchMenu

This resource specification was automatically generated
by the MenuEditor of ST/X.

Usage example(s):

MenuEditor new openOnClass:FindFileApplication andSelector:#searchMenu (Menu new fromLiteralArrayEncoding:(FindFileApplication searchMenu)) startUp

 releaseContentsInfoCache

 searchResultTable

This resource specification was automatically generated
by the DataSetBuilder of ST/X.

Usage example(s):

DataSetBuilder new openOnClass:FindFileApplication andSelector:#searchResultTable

Instance protocol:

 clearCache

 clearResultList

 deleteAllFiles

 deleteFiles: colOfFiles confirm: confirm

delete current selected files/directories

 deleteSelectedFiles

cg: huch: result is always nil here

 doCompareTwoFiles

 doSearch

self changeExtentToSeeSearchResult.

 fileInInBrowser

 namePatternsFor: namePatternArg ignoringCase: ignoringCase

 removeFilesFromResultList: listOfFiles

 removeSelectedFilesFromResultList

 showMatchedFiles: aBoolean

 touchAllFiles

 touchFiles: colOfFiles

touch current selected files/directories

 touchSelectedFiles

 commitSelectedFilesToCVS

 deleteSelectedFilesAndCVSContainers

 canUseGrep

grep command is much faster, but:
- not under MSDOS

 canUseLocate

locate command is much faster, but:
- only if searching recursively,
- no case ignore
- no contents matching

 contentsPatternHolder

(comment from inherited method)
to be redefined

 enableFileSizeFilter

 enableFileSizeFilterAndNotSearchForSameContents

 enableModificationTimeFilter

 excludedNamePatternHolder

 fileSizeHolder

 fileSizeOperatorHolder

 fileSizeUnitHolder

 ignoreCaseInContents

(comment from inherited method)
to be redefined

 ignoreCaseInExcludedName

 ignoreCaseInName

Modified (format): / 03-08-2011 / 18:05:49 / cg

 ignoreCaseInNotContents

 lookIntoZipsHolder

 modificationTimeHolder

 modificationTimeOperatorHolder

 modificationTimeOperatorIndexHolder

 modificationTimeOperatorLabelList

 modificationTimeOperatorSpecList

 modificationTimeOperatorValueList

 namePatternHolder

 notContentsPatternHolder

 notSearchForSameContents

 notShowingMatchedFiles

 rememberInCache

 sameContentsAsHolder

 searchDirectories

 searchDirectoryHolder

 searchForBinaryContentsHolder

 searchForSameContents

 searchOnlyInCache

 showUnreadableFilesAndDirectoriesHolder

 showingMatchedFiles

 useGrep

 useLocate

 modificationTimeOperatorChanged

 changeExtentToSeeSearchResult

 cachedFileSizeOf: aFilenameString

 cachedHashValueOfFile: aFilenameString

 contentsInfoCache

 doFindFileNamed: namePatterns directories: searchDirectories ignoreCase: ignCaseInName containingString: contentsStringArg ignoreCaseInContents: ignCaseInContents notContainingString: notContentsStringArg ignoreCaseInNotContents: ignCaseInNotContents sameContentsAsFile: filenameToCompareContentsOrNil sameContentsAs: bytesToCompareContentsOrNil in: aDirectory

only for backward compatibility...

 doFindFileNamed: namePatterns directories: searchDirectoriesArg ignoreCaseInName: ignCaseInName excludeFilesNamed: excludedNamePatterns ignoreCaseInExcludedName: ignoreCaseInExcludedNameArg containingString: contentsStringArg ignoreCaseInContents: ignCaseInContents notContainingString: notContentsStringArg ignoreCaseInNotContents: ignCaseInNotContents sameContentsAsFile: filenameToCompareContentsOrNil sameContentsAs: bytesToCompareContentsOrNil in: aDirectoryOrCollectionOfDirectories

the main workhorse for searching files.
Creates optimized search blocks, depending on how we search,
and passes these to the recursive directory walker.
(got too big, and may need some splitting/refactoring

 doFindFileNamed: namePatterns directories: searchDirectories nameMatch: nameMatch contentsMatch: doesFileMatch in: aDirectory

the recursive walker.
Searches for files matching name match-block,
and contents matching doesFileMatch-block.
Adds matching files to the resultList instVar.

Returns true if there was a namePatterns-match
(but only for namePatterns - not for nameMatch or doesFileMatch)

 fileSizeWrapperFor: aFileMatchBlock

possibly wrap the search-match block into a file-size matcher block

 flushOutdatedCacheInformationBelow: srchDir

flush if required

 modificationTimeWrapperFor: aFileMatchBlock

possibly wrap the search-match block into a modification time matcher block

 searchWithCheck: check easyCheck: easyCheck checkNot: checkNot forContents: contentsString ignoreCase: ignCaseInContents forNotContents: notContentsString ignoreCase: ignCaseInNotContents inFile: aFile orStream: inStream streamSize: inStreamSize streamName: inStreamName

inStream and inStreamSize are non-nil when searchin in a zip entry

 getTabValueString

the item shown in a tab (not language translated)

 initialize

must be called if redefined

 item: anItem

(comment from inherited method)
self halt.

 postOpenWith: aBuilder

Modified (format): / 12-01-2012 / 01:40:44 / cg

 release

(comment from inherited method)
remove all references to objects that may refer to self.
Subclasses may redefine this method but should do a 'super release'.

Examples:

   FindFileApplication open

   FindFileApplication openOn:aModel