| | import java.util.*; |
| | import java.util.concurrent.atomic.AtomicBoolean; |
| | - |
| | -import static com.keenwrite.Constants.*; |
| | -import static com.keenwrite.ExportFormat.NONE; |
| | -import static com.keenwrite.Messages.get; |
| | -import static com.keenwrite.StatusBarNotifier.clue; |
| | -import static com.keenwrite.io.MediaType.*; |
| | -import static com.keenwrite.preferences.Workspace.*; |
| | -import static com.keenwrite.processors.ProcessorFactory.createProcessors; |
| | -import static com.keenwrite.service.events.Notifier.NO; |
| | -import static com.keenwrite.service.events.Notifier.YES; |
| | -import static java.util.Arrays.asList; |
| | -import static javafx.application.Platform.runLater; |
| | -import static javafx.scene.control.TabPane.TabClosingPolicy.ALL_TABS; |
| | -import static javafx.scene.input.KeyCode.SPACE; |
| | -import static javafx.scene.input.KeyCombination.CONTROL_DOWN; |
| | -import static javafx.util.Duration.millis; |
| | -import static org.fxmisc.wellbehaved.event.EventPattern.keyPressed; |
| | - |
| | -/** |
| | - * Responsible for wiring together the main application components for a |
| | - * particular workspace (project). These include the definition views, |
| | - * text editors, and preview pane along with any corresponding controllers. |
| | - */ |
| | -public final class MainPane extends SplitPane { |
| | - private static final Notifier sNotifier = Services.load( Notifier.class ); |
| | - |
| | - /** |
| | - * Prevents re-instantiation of processing classes. |
| | - */ |
| | - private final Map<TextResource, Processor<String>> mProcessors = |
| | - new HashMap<>(); |
| | - |
| | - private final Workspace mWorkspace; |
| | - |
| | - /** |
| | - * Groups similar file type tabs together. |
| | - */ |
| | - private final Map<MediaType, DetachableTabPane> mTabPanes = new HashMap<>(); |
| | - |
| | - /** |
| | - * Stores definition names and values. |
| | - */ |
| | - private final Map<String, String> mResolvedMap = |
| | - new HashMap<>( MAP_SIZE_DEFAULT ); |
| | - |
| | - /** |
| | - * Renders the actively selected plain text editor tab. |
| | - */ |
| | - private final HtmlPreview mHtmlPreview; |
| | - |
| | - /** |
| | - * Changing the active editor fires the value changed event. This allows |
| | - * refreshes to happen when external definitions are modified and need to |
| | - * trigger the processing chain. |
| | - */ |
| | - private final ObjectProperty<TextEditor> mActiveTextEditor = |
| | - createActiveTextEditor(); |
| | - |
| | - /** |
| | - * Changing the active definition editor fires the value changed event. This |
| | - * allows refreshes to happen when external definitions are modified and need |
| | - * to trigger the processing chain. |
| | - */ |
| | - private final ObjectProperty<TextDefinition> mActiveDefinitionEditor = |
| | - createActiveDefinitionEditor( mActiveTextEditor ); |
| | - |
| | - /** |
| | - * Responsible for creating a new scene when a tab is detached into |
| | - * its own window frame. |
| | - */ |
| | - private final DefinitionTabSceneFactory mDefinitionTabSceneFactory = |
| | - createDefinitionTabSceneFactory( mActiveDefinitionEditor ); |
| | - |
| | - /** |
| | - * Tracks the number of detached tab panels opened into their own windows, |
| | - * which allows unique identification of subordinate windows by their title. |
| | - * It is doubtful more than 128 windows, much less 256, will be created. |
| | - */ |
| | - private byte mWindowCount; |
| | - |
| | - /** |
| | - * Called when the definition data is changed. |
| | - */ |
| | - private final EventHandler<TreeModificationEvent<Event>> mTreeHandler = |
| | - event -> { |
| | - final var editor = mActiveDefinitionEditor.get(); |
| | - |
| | - resolve( editor ); |
| | - process( getActiveTextEditor() ); |
| | - save( editor ); |
| | - }; |
| | - |
| | - /** |
| | - * Adds all content panels to the main user interface. This will load the |
| | - * configuration settings from the workspace to reproduce the settings from |
| | - * a previous session. |
| | - */ |
| | - public MainPane( final Workspace workspace ) { |
| | - mWorkspace = workspace; |
| | - mHtmlPreview = new HtmlPreview( workspace ); |
| | - |
| | - open( bin( getRecentFiles() ) ); |
| | - |
| | - final var tabPane = obtainDetachableTabPane( TEXT_HTML ); |
| | - tabPane.addTab( "HTML", mHtmlPreview ); |
| | - addTabPane( tabPane ); |
| | - |
| | - final var ratio = 100f / getItems().size() / 100; |
| | - final var positions = getDividerPositions(); |
| | - |
| | - for( int i = 0; i < positions.length; i++ ) { |
| | - positions[ i ] = ratio * i; |
| | - } |
| | - |
| | - // TODO: Load divider positions from exported settings, see bin() comment. |
| | - setDividerPositions( positions ); |
| | - |
| | - // Once the main scene's window regains focus, update the active definition |
| | - // editor to the currently selected tab. |
| | - runLater( |
| | - () -> getWindow().focusedProperty().addListener( ( c, o, n ) -> { |
| | - if( n != null && n ) { |
| | - final var pane = mTabPanes.get( TEXT_YAML ); |
| | - final var model = pane.getSelectionModel(); |
| | - final var tab = model.getSelectedItem(); |
| | - |
| | - if( tab != null ) { |
| | - final var editor = (TextDefinition) tab.getContent(); |
| | - |
| | - mActiveDefinitionEditor.set( editor ); |
| | - } |
| | - } |
| | - } ) |
| | - ); |
| | - |
| | - forceRepaint(); |
| | - } |
| | - |
| | - /** |
| | - * Force preview pane refresh on Windows. |
| | - */ |
| | - private void forceRepaint() { |
| | -// if( IS_OS_WINDOWS ) { |
| | -// splitPane.getDividers().get( 1 ).positionProperty().addListener( |
| | -// ( l, oValue, nValue ) -> runLater( |
| | -// () -> getHtmlPreview().repaintScrollPane() |
| | -// ) |
| | -// ); |
| | -// } |
| | - } |
| | - |
| | - /** |
| | - * Opens all the files into the application, provided the paths are unique. |
| | - * This may only be called for any type of files that a user can edit |
| | - * (i.e., update and persist), such as definitions and text files. |
| | - * |
| | - * @param files The list of files to open. |
| | - */ |
| | - public void open( final List<File> files ) { |
| | - files.forEach( this::open ); |
| | - } |
| | - |
| | - /** |
| | - * This opens the given file. Since the preview pane is not a file that |
| | - * can be opened, it is safe to add a listener to the detachable pane. |
| | - * |
| | - * @param file The file to open. |
| | - */ |
| | - private void open( final File file ) { |
| | - final var tab = createTab( file ); |
| | - final var node = tab.getContent(); |
| | - final var mediaType = MediaType.valueFrom( file ); |
| | - final var tabPane = obtainDetachableTabPane( mediaType ); |
| | - final var newTabPane = !getItems().contains( tabPane ); |
| | - |
| | - tab.setTooltip( createTooltip( file ) ); |
| | - tabPane.setFocusTraversable( false ); |
| | - tabPane.setTabClosingPolicy( ALL_TABS ); |
| | - tabPane.getTabs().add( tab ); |
| | - |
| | - if( newTabPane ) { |
| | - var index = getItems().size(); |
| | - |
| | - if( node instanceof TextDefinition ) { |
| | - tabPane.setSceneFactory( mDefinitionTabSceneFactory::create ); |
| | - index = 0; |
| | - } |
| | - |
| | - addTabPane( index, tabPane ); |
| | - } |
| | - |
| | - getRecentFiles().add( file.getAbsolutePath() ); |
| | - } |
| | - |
| | - /** |
| | - * Opens a new text editor document using the default document file name. |
| | - */ |
| | - public void newTextEditor() { |
| | - open( DOCUMENT_DEFAULT ); |
| | - } |
| | - |
| | - /** |
| | - * Opens a new definition editor document using the default definition |
| | - * file name. |
| | - */ |
| | - public void newDefinitionEditor() { |
| | - open( DEFINITION_DEFAULT ); |
| | - } |
| | - |
| | - /** |
| | - * Iterates over all tab panes to find all {@link TextEditor}s and request |
| | - * that they save themselves. |
| | - */ |
| | - public void saveAll() { |
| | - mTabPanes.forEach( |
| | - ( mt, tp ) -> tp.getTabs().forEach( ( tab ) -> { |
| | - final var node = tab.getContent(); |
| | - if( node instanceof TextEditor ) { |
| | - save( ((TextEditor) node) ); |
| | - } |
| | - } ) |
| | - ); |
| | - } |
| | - |
| | - /** |
| | - * Requests that the active {@link TextEditor} saves itself. Don't bother |
| | - * checking if modified first because if the user swaps external media from |
| | - * an external source (e.g., USB thumb drive), save should not second-guess |
| | - * the user: save always re-saves. Also, it's less code. |
| | - */ |
| | - public void save() { |
| | - save( getActiveTextEditor() ); |
| | - } |
| | - |
| | - /** |
| | - * Saves the active {@link TextEditor} under a new name. |
| | - * |
| | - * @param file The new active editor {@link File} reference. |
| | - */ |
| | - public void saveAs( final File file ) { |
| | - assert file != null; |
| | - final var editor = getActiveTextEditor(); |
| | - final var tab = getTab( editor ); |
| | - |
| | - editor.rename( file ); |
| | - tab.ifPresent( t -> { |
| | - t.setText( editor.getFilename() ); |
| | - t.setTooltip( createTooltip( file ) ); |
| | - } ); |
| | - |
| | - save(); |
| | - } |
| | - |
| | - /** |
| | - * Saves the given {@link TextResource} to a file. This is typically used |
| | - * to save either an instance of {@link TextEditor} or {@link TextDefinition}. |
| | - * |
| | - * @param resource The resource to export. |
| | - */ |
| | - private void save( final TextResource resource ) { |
| | - try { |
| | - resource.save(); |
| | - } catch( final Exception ex ) { |
| | - clue( ex ); |
| | - sNotifier.alert( |
| | - getWindow(), resource.getPath(), "TextResource.saveFailed", ex |
| | - ); |
| | - } |
| | - } |
| | - |
| | - /** |
| | - * Closes all open {@link TextEditor}s; all {@link TextDefinition}s stay open. |
| | - * |
| | - * @return {@code true} when all editors, modified or otherwise, were |
| | - * permitted to close; {@code false} when one or more editors were modified |
| | - * and the user requested no closing. |
| | - */ |
| | - public boolean closeAll() { |
| | - var closable = true; |
| | - |
| | - for( final var entry : mTabPanes.entrySet() ) { |
| | - final var tabPane = entry.getValue(); |
| | - final var tabIterator = tabPane.getTabs().iterator(); |
| | - |
| | - while( tabIterator.hasNext() ) { |
| | - final var tab = tabIterator.next(); |
| | - final var node = tab.getContent(); |
| | - |
| | - if( node instanceof TextEditor && |
| | - (closable &= canClose( (TextEditor) node )) ) { |
| | - tabIterator.remove(); |
| | - close( tab ); |
| | - } |
| | - } |
| | - } |
| | - |
| | - return closable; |
| | - } |
| | - |
| | - /** |
| | - * Calls the tab's {@link Tab#getOnClosed()} handler to carry out a close |
| | - * event. |
| | - * |
| | - * @param tab The {@link Tab} that was closed. |
| | - */ |
| | - private void close( final Tab tab ) { |
| | - final var handler = tab.getOnClosed(); |
| | - |
| | - if( handler != null ) { |
| | - handler.handle( new ActionEvent() ); |
| | - } |
| | - } |
| | - |
| | - /** |
| | - * Closes the active tab; delegates to {@link #canClose(TextEditor)}. |
| | - */ |
| | - public void close() { |
| | - final var editor = getActiveTextEditor(); |
| | - if( canClose( editor ) ) { |
| | - close( editor ); |
| | - } |
| | - } |
| | - |
| | - /** |
| | - * Closes the given {@link TextEditor}. This must not be called from within |
| | - * a loop that iterates over the tab panes using {@code forEach}, lest a |
| | - * concurrent modification exception be thrown. |
| | - * |
| | - * @param editor The {@link TextEditor} to close, without confirming with |
| | - * the user. |
| | - */ |
| | - private void close( final TextEditor editor ) { |
| | - getTab( editor ).ifPresent( |
| | - ( tab ) -> { |
| | - tab.getTabPane().getTabs().remove( tab ); |
| | - close( tab ); |
| | - } |
| | - ); |
| | - } |
| | - |
| | - /** |
| | - * Answers whether the given {@link TextEditor} may be closed. |
| | - * |
| | - * @param editor The {@link TextEditor} to try closing. |
| | - * @return {@code true} when the editor may be closed; {@code false} when |
| | - * the user has requested to keep the editor open. |
| | - */ |
| | - private boolean canClose( final TextEditor editor ) { |
| | - final var editorTab = getTab( editor ); |
| | - final var canClose = new AtomicBoolean( true ); |
| | - |
| | - if( editor.isModified() ) { |
| | - final var filename = new StringBuilder(); |
| | - editorTab.ifPresent( ( tab ) -> filename.append( tab.getText() ) ); |
| | - |
| | - final var message = sNotifier.createNotification( |
| | - Messages.get( "Alert.file.close.title" ), |
| | - Messages.get( "Alert.file.close.text" ), |
| | - filename.toString() |
| | - ); |
| | - |
| | - final var dialog = sNotifier.createConfirmation( getWindow(), message ); |
| | - |
| | - dialog.showAndWait().ifPresent( |
| | - save -> canClose.set( save == YES ? editor.save() : save == NO ) |
| | - ); |
| | - } |
| | - |
| | - return canClose.get(); |
| | - } |
| | - |
| | - private ObjectProperty<TextEditor> createActiveTextEditor() { |
| | - final var editor = new SimpleObjectProperty<TextEditor>(); |
| | - |
| | - editor.addListener( ( c, o, n ) -> { |
| | - if( n != null ) { |
| | - mHtmlPreview.setBaseUri( n.getPath() ); |
| | - process( n ); |
| | - } |
| | - } ); |
| | - |
| | - return editor; |
| | - } |
| | - |
| | - /** |
| | - * Returns the tab that contains the given {@link TextEditor}. |
| | - * |
| | - * @param editor The {@link TextEditor} instance to find amongst the tabs. |
| | - * @return The first tab having content that matches the given tab. |
| | - */ |
| | - private Optional<Tab> getTab( final TextEditor editor ) { |
| | - return mTabPanes.values() |
| | - .stream() |
| | - .flatMap( pane -> pane.getTabs().stream() ) |
| | - .filter( tab -> editor.equals( tab.getContent() ) ) |
| | - .findFirst(); |
| | - } |
| | - |
| | - /** |
| | - * Creates a new {@link DefinitionEditor} wrapped in a listener that |
| | - * is used to detect when the active {@link DefinitionEditor} has changed. |
| | - * Upon changing, the {@link #mResolvedMap} is updated and the active |
| | - * text editor is refreshed. |
| | - * |
| | - * @param editor Text editor to update with the revised resolved map. |
| | - * @return A newly configured property that represents the active |
| | - * {@link DefinitionEditor}, never null. |
| | - */ |
| | - private ObjectProperty<TextDefinition> createActiveDefinitionEditor( |
| | - final ObjectProperty<TextEditor> editor ) { |
| | - final var definitions = new SimpleObjectProperty<TextDefinition>(); |
| | - definitions.addListener( ( c, o, n ) -> { |
| | - resolve( n == null ? createDefinitionEditor() : n ); |
| | - process( editor.get() ); |
| | - } ); |
| | - |
| | - return definitions; |
| | - } |
| | - |
| | - /** |
| | - * Instantiates a factory that's responsible for creating new scenes when |
| | - * a tab is dropped outside of any application window. The definition tabs |
| | - * are fairly complex in that only one may be active at any time. When |
| | - * activated, the {@link #mResolvedMap} must be updated to reflect the |
| | - * hierarchy displayed in the {@link DefinitionEditor}. |
| | - * |
| | - * @param activeDefinitionEditor The current {@link DefinitionEditor}. |
| | - * @return An object that listens to {@link DefinitionEditor} tab focus |
| | - * changes. |
| | - */ |
| | - private DefinitionTabSceneFactory createDefinitionTabSceneFactory( |
| | - final ObjectProperty<TextDefinition> activeDefinitionEditor ) { |
| | - return new DefinitionTabSceneFactory( ( tab ) -> { |
| | - assert tab != null; |
| | - |
| | - var node = tab.getContent(); |
| | - if( node instanceof TextDefinition ) { |
| | - activeDefinitionEditor.set( (DefinitionEditor) node ); |
| | - } |
| | - } ); |
| | - } |
| | - |
| | - private DetachableTab createTab( final File file ) { |
| | - final var r = createTextResource( file ); |
| | - final var tab = new DetachableTab( r.getFilename(), r.getNode() ); |
| | - |
| | - r.modifiedProperty().addListener( |
| | - ( c, o, n ) -> tab.setText( r.getFilename() + (n ? "*" : "") ) |
| | - ); |
| | - |
| | - // This is called when either the tab is closed by the user clicking on |
| | - // the tab's close icon or when closing (all) from the file menu. |
| | - tab.setOnClosed( |
| | - ( __ ) -> getRecentFiles().remove( file.getAbsolutePath() ) |
| | - ); |
| | - |
| | - return tab; |
| | - } |
| | - |
| | - /** |
| | - * Creates bins for the different {@link MediaType}s, which eventually are |
| | - * added to the UI as separate tab panes. If ever a general-purpose scene |
| | - * exporter is developed to serialize a scene to an FXML file, this could |
| | - * be replaced by such a class. |
| | - * <p> |
| | - * When binning the files, this makes sure that at least one file exists |
| | - * for every type. If the user has opted to close a particular type (such |
| | - * as the definition pane), the view will suppressed elsewhere. |
| | - * </p> |
| | - * <p> |
| | - * The order that the binned files are returned will be reflected in the |
| | - * order that the corresponding panes are rendered in the UI. Each different |
| | - * {@link MediaType} will be created in its own pane. Order is maintained |
| | - * by using {@link LinkedHashSet} instances. |
| | - * </p> |
| | - * |
| | - * @param paths The file paths to bin by {@link MediaType}. |
| | - * @return An in-order list of files, first by structured definition files, |
| | - * then by plain text documents. |
| | - */ |
| | - private List<File> bin( final SetProperty<String> paths ) { |
| | - final var bins = new HashMap<MediaType, Set<File>>(); |
| | - final var sets = List.of( |
| | - createBin( TEXT_YAML ), |
| | - createBin( TEXT_MARKDOWN, TEXT_R_MARKDOWN, TEXT_R_XML ), |
| | - createBin( UNDEFINED ) |
| | - ); |
| | - |
| | - sets.forEach( ( set ) -> set.forEach( |
| | - ( type ) -> bins.put( type, new LinkedHashSet<>() ) |
| | - ) ); |
| | - |
| | - paths.forEach( ( path ) -> { |
| | - final var file = new File( path ); |
| | - |
| | - final var set = bins.computeIfAbsent( |
| | - MediaType.valueFrom( file ), k -> new LinkedHashSet<>() |
| | - ); |
| | - |
| | - set.add( file ); |
| | - } ); |
| | - |
| | - final var result = new ArrayList<File>( paths.size() ); |
| | - |
| | - sets.forEach( ( set ) -> set.forEach( ( type ) -> { |
| | - final var bin = bins.get( type ); |
| | - |
| | - if( bin.isEmpty() ) { |
| | - switch( type ) { |
| | - case TEXT_YAML -> bin.add( DEFINITION_DEFAULT ); |
| | - case TEXT_MARKDOWN -> bin.add( DOCUMENT_DEFAULT ); |
| | - } |
| | - } |
| | - |
| | - result.addAll( bin ); |
| | - } ) ); |
| | - |
| | - return result; |
| | - } |
| | - |
| | - private Set<MediaType> createBin( final MediaType... bins ) { |
| | - return new HashSet<>( asList( bins ) ); |
| | +import java.util.function.Function; |
| | +import java.util.stream.Collectors; |
| | + |
| | +import static com.keenwrite.Constants.*; |
| | +import static com.keenwrite.ExportFormat.NONE; |
| | +import static com.keenwrite.Messages.get; |
| | +import static com.keenwrite.StatusBarNotifier.clue; |
| | +import static com.keenwrite.io.MediaType.*; |
| | +import static com.keenwrite.preferences.Workspace.*; |
| | +import static com.keenwrite.processors.ProcessorFactory.createProcessors; |
| | +import static com.keenwrite.service.events.Notifier.NO; |
| | +import static com.keenwrite.service.events.Notifier.YES; |
| | +import static java.util.stream.Collectors.groupingBy; |
| | +import static javafx.application.Platform.runLater; |
| | +import static javafx.scene.control.TabPane.TabClosingPolicy.ALL_TABS; |
| | +import static javafx.scene.input.KeyCode.SPACE; |
| | +import static javafx.scene.input.KeyCombination.CONTROL_DOWN; |
| | +import static javafx.util.Duration.millis; |
| | +import static org.fxmisc.wellbehaved.event.EventPattern.keyPressed; |
| | + |
| | +/** |
| | + * Responsible for wiring together the main application components for a |
| | + * particular workspace (project). These include the definition views, |
| | + * text editors, and preview pane along with any corresponding controllers. |
| | + */ |
| | +public final class MainPane extends SplitPane { |
| | + private static final Notifier sNotifier = Services.load( Notifier.class ); |
| | + |
| | + /** |
| | + * Used when opening files to determine how each file should be binned and |
| | + * therefore what tab pane to be opened within. |
| | + */ |
| | + private static final Set<MediaType> PLAIN_TEXT_FORMAT = Set.of( |
| | + TEXT_MARKDOWN, TEXT_R_MARKDOWN, TEXT_R_XML, UNDEFINED |
| | + ); |
| | + |
| | + /** |
| | + * Prevents re-instantiation of processing classes. |
| | + */ |
| | + private final Map<TextResource, Processor<String>> mProcessors = |
| | + new HashMap<>(); |
| | + |
| | + private final Workspace mWorkspace; |
| | + |
| | + /** |
| | + * Groups similar file type tabs together. |
| | + */ |
| | + private final Map<MediaType, DetachableTabPane> mTabPanes = new HashMap<>(); |
| | + |
| | + /** |
| | + * Stores definition names and values. |
| | + */ |
| | + private final Map<String, String> mResolvedMap = |
| | + new HashMap<>( MAP_SIZE_DEFAULT ); |
| | + |
| | + /** |
| | + * Renders the actively selected plain text editor tab. |
| | + */ |
| | + private final HtmlPreview mHtmlPreview; |
| | + |
| | + /** |
| | + * Changing the active editor fires the value changed event. This allows |
| | + * refreshes to happen when external definitions are modified and need to |
| | + * trigger the processing chain. |
| | + */ |
| | + private final ObjectProperty<TextEditor> mActiveTextEditor = |
| | + createActiveTextEditor(); |
| | + |
| | + /** |
| | + * Changing the active definition editor fires the value changed event. This |
| | + * allows refreshes to happen when external definitions are modified and need |
| | + * to trigger the processing chain. |
| | + */ |
| | + private final ObjectProperty<TextDefinition> mActiveDefinitionEditor = |
| | + createActiveDefinitionEditor( mActiveTextEditor ); |
| | + |
| | + /** |
| | + * Responsible for creating a new scene when a tab is detached into |
| | + * its own window frame. |
| | + */ |
| | + private final DefinitionTabSceneFactory mDefinitionTabSceneFactory = |
| | + createDefinitionTabSceneFactory( mActiveDefinitionEditor ); |
| | + |
| | + /** |
| | + * Tracks the number of detached tab panels opened into their own windows, |
| | + * which allows unique identification of subordinate windows by their title. |
| | + * It is doubtful more than 128 windows, much less 256, will be created. |
| | + */ |
| | + private byte mWindowCount; |
| | + |
| | + /** |
| | + * Called when the definition data is changed. |
| | + */ |
| | + private final EventHandler<TreeModificationEvent<Event>> mTreeHandler = |
| | + event -> { |
| | + final var editor = mActiveDefinitionEditor.get(); |
| | + |
| | + resolve( editor ); |
| | + process( getActiveTextEditor() ); |
| | + save( editor ); |
| | + }; |
| | + |
| | + /** |
| | + * Adds all content panels to the main user interface. This will load the |
| | + * configuration settings from the workspace to reproduce the settings from |
| | + * a previous session. |
| | + */ |
| | + public MainPane( final Workspace workspace ) { |
| | + mWorkspace = workspace; |
| | + mHtmlPreview = new HtmlPreview( workspace ); |
| | + |
| | + open( bin( getRecentFiles() ) ); |
| | + |
| | + final var tabPane = obtainDetachableTabPane( TEXT_HTML ); |
| | + tabPane.addTab( "HTML", mHtmlPreview ); |
| | + addTabPane( tabPane ); |
| | + |
| | + final var ratio = 100f / getItems().size() / 100; |
| | + final var positions = getDividerPositions(); |
| | + |
| | + for( int i = 0; i < positions.length; i++ ) { |
| | + positions[ i ] = ratio * i; |
| | + } |
| | + |
| | + // TODO: Load divider positions from exported settings, see bin() comment. |
| | + setDividerPositions( positions ); |
| | + |
| | + // Once the main scene's window regains focus, update the active definition |
| | + // editor to the currently selected tab. |
| | + runLater( |
| | + () -> getWindow().focusedProperty().addListener( ( c, o, n ) -> { |
| | + if( n != null && n ) { |
| | + final var pane = mTabPanes.get( TEXT_YAML ); |
| | + final var model = pane.getSelectionModel(); |
| | + final var tab = model.getSelectedItem(); |
| | + |
| | + if( tab != null ) { |
| | + final var editor = (TextDefinition) tab.getContent(); |
| | + |
| | + mActiveDefinitionEditor.set( editor ); |
| | + } |
| | + } |
| | + } ) |
| | + ); |
| | + |
| | + forceRepaint(); |
| | + } |
| | + |
| | + /** |
| | + * Force preview pane refresh on Windows. |
| | + */ |
| | + private void forceRepaint() { |
| | +// if( IS_OS_WINDOWS ) { |
| | +// splitPane.getDividers().get( 1 ).positionProperty().addListener( |
| | +// ( l, oValue, nValue ) -> runLater( |
| | +// () -> getHtmlPreview().repaintScrollPane() |
| | +// ) |
| | +// ); |
| | +// } |
| | + } |
| | + |
| | + /** |
| | + * Opens all the files into the application, provided the paths are unique. |
| | + * This may only be called for any type of files that a user can edit |
| | + * (i.e., update and persist), such as definitions and text files. |
| | + * |
| | + * @param files The list of files to open. |
| | + */ |
| | + public void open( final List<File> files ) { |
| | + files.forEach( this::open ); |
| | + } |
| | + |
| | + /** |
| | + * This opens the given file. Since the preview pane is not a file that |
| | + * can be opened, it is safe to add a listener to the detachable pane. |
| | + * |
| | + * @param file The file to open. |
| | + */ |
| | + private void open( final File file ) { |
| | + final var tab = createTab( file ); |
| | + final var node = tab.getContent(); |
| | + final var mediaType = MediaType.valueFrom( file ); |
| | + final var tabPane = obtainDetachableTabPane( mediaType ); |
| | + final var newTabPane = !getItems().contains( tabPane ); |
| | + |
| | + tab.setTooltip( createTooltip( file ) ); |
| | + tabPane.setFocusTraversable( false ); |
| | + tabPane.setTabClosingPolicy( ALL_TABS ); |
| | + tabPane.getTabs().add( tab ); |
| | + |
| | + if( newTabPane ) { |
| | + var index = getItems().size(); |
| | + |
| | + if( node instanceof TextDefinition ) { |
| | + tabPane.setSceneFactory( mDefinitionTabSceneFactory::create ); |
| | + index = 0; |
| | + } |
| | + |
| | + addTabPane( index, tabPane ); |
| | + } |
| | + |
| | + getRecentFiles().add( file.getAbsolutePath() ); |
| | + } |
| | + |
| | + /** |
| | + * Opens a new text editor document using the default document file name. |
| | + */ |
| | + public void newTextEditor() { |
| | + open( DOCUMENT_DEFAULT ); |
| | + } |
| | + |
| | + /** |
| | + * Opens a new definition editor document using the default definition |
| | + * file name. |
| | + */ |
| | + public void newDefinitionEditor() { |
| | + open( DEFINITION_DEFAULT ); |
| | + } |
| | + |
| | + /** |
| | + * Iterates over all tab panes to find all {@link TextEditor}s and request |
| | + * that they save themselves. |
| | + */ |
| | + public void saveAll() { |
| | + mTabPanes.forEach( |
| | + ( mt, tp ) -> tp.getTabs().forEach( ( tab ) -> { |
| | + final var node = tab.getContent(); |
| | + if( node instanceof TextEditor ) { |
| | + save( ((TextEditor) node) ); |
| | + } |
| | + } ) |
| | + ); |
| | + } |
| | + |
| | + /** |
| | + * Requests that the active {@link TextEditor} saves itself. Don't bother |
| | + * checking if modified first because if the user swaps external media from |
| | + * an external source (e.g., USB thumb drive), save should not second-guess |
| | + * the user: save always re-saves. Also, it's less code. |
| | + */ |
| | + public void save() { |
| | + save( getActiveTextEditor() ); |
| | + } |
| | + |
| | + /** |
| | + * Saves the active {@link TextEditor} under a new name. |
| | + * |
| | + * @param file The new active editor {@link File} reference. |
| | + */ |
| | + public void saveAs( final File file ) { |
| | + assert file != null; |
| | + final var editor = getActiveTextEditor(); |
| | + final var tab = getTab( editor ); |
| | + |
| | + editor.rename( file ); |
| | + tab.ifPresent( t -> { |
| | + t.setText( editor.getFilename() ); |
| | + t.setTooltip( createTooltip( file ) ); |
| | + } ); |
| | + |
| | + save(); |
| | + } |
| | + |
| | + /** |
| | + * Saves the given {@link TextResource} to a file. This is typically used |
| | + * to save either an instance of {@link TextEditor} or {@link TextDefinition}. |
| | + * |
| | + * @param resource The resource to export. |
| | + */ |
| | + private void save( final TextResource resource ) { |
| | + try { |
| | + resource.save(); |
| | + } catch( final Exception ex ) { |
| | + clue( ex ); |
| | + sNotifier.alert( |
| | + getWindow(), resource.getPath(), "TextResource.saveFailed", ex |
| | + ); |
| | + } |
| | + } |
| | + |
| | + /** |
| | + * Closes all open {@link TextEditor}s; all {@link TextDefinition}s stay open. |
| | + * |
| | + * @return {@code true} when all editors, modified or otherwise, were |
| | + * permitted to close; {@code false} when one or more editors were modified |
| | + * and the user requested no closing. |
| | + */ |
| | + public boolean closeAll() { |
| | + var closable = true; |
| | + |
| | + for( final var entry : mTabPanes.entrySet() ) { |
| | + final var tabPane = entry.getValue(); |
| | + final var tabIterator = tabPane.getTabs().iterator(); |
| | + |
| | + while( tabIterator.hasNext() ) { |
| | + final var tab = tabIterator.next(); |
| | + final var node = tab.getContent(); |
| | + |
| | + if( node instanceof TextEditor && |
| | + (closable &= canClose( (TextEditor) node )) ) { |
| | + tabIterator.remove(); |
| | + close( tab ); |
| | + } |
| | + } |
| | + } |
| | + |
| | + return closable; |
| | + } |
| | + |
| | + /** |
| | + * Calls the tab's {@link Tab#getOnClosed()} handler to carry out a close |
| | + * event. |
| | + * |
| | + * @param tab The {@link Tab} that was closed. |
| | + */ |
| | + private void close( final Tab tab ) { |
| | + final var handler = tab.getOnClosed(); |
| | + |
| | + if( handler != null ) { |
| | + handler.handle( new ActionEvent() ); |
| | + } |
| | + } |
| | + |
| | + /** |
| | + * Closes the active tab; delegates to {@link #canClose(TextEditor)}. |
| | + */ |
| | + public void close() { |
| | + final var editor = getActiveTextEditor(); |
| | + if( canClose( editor ) ) { |
| | + close( editor ); |
| | + } |
| | + } |
| | + |
| | + /** |
| | + * Closes the given {@link TextEditor}. This must not be called from within |
| | + * a loop that iterates over the tab panes using {@code forEach}, lest a |
| | + * concurrent modification exception be thrown. |
| | + * |
| | + * @param editor The {@link TextEditor} to close, without confirming with |
| | + * the user. |
| | + */ |
| | + private void close( final TextEditor editor ) { |
| | + getTab( editor ).ifPresent( |
| | + ( tab ) -> { |
| | + tab.getTabPane().getTabs().remove( tab ); |
| | + close( tab ); |
| | + } |
| | + ); |
| | + } |
| | + |
| | + /** |
| | + * Answers whether the given {@link TextEditor} may be closed. |
| | + * |
| | + * @param editor The {@link TextEditor} to try closing. |
| | + * @return {@code true} when the editor may be closed; {@code false} when |
| | + * the user has requested to keep the editor open. |
| | + */ |
| | + private boolean canClose( final TextEditor editor ) { |
| | + final var editorTab = getTab( editor ); |
| | + final var canClose = new AtomicBoolean( true ); |
| | + |
| | + if( editor.isModified() ) { |
| | + final var filename = new StringBuilder(); |
| | + editorTab.ifPresent( ( tab ) -> filename.append( tab.getText() ) ); |
| | + |
| | + final var message = sNotifier.createNotification( |
| | + Messages.get( "Alert.file.close.title" ), |
| | + Messages.get( "Alert.file.close.text" ), |
| | + filename.toString() |
| | + ); |
| | + |
| | + final var dialog = sNotifier.createConfirmation( getWindow(), message ); |
| | + |
| | + dialog.showAndWait().ifPresent( |
| | + save -> canClose.set( save == YES ? editor.save() : save == NO ) |
| | + ); |
| | + } |
| | + |
| | + return canClose.get(); |
| | + } |
| | + |
| | + private ObjectProperty<TextEditor> createActiveTextEditor() { |
| | + final var editor = new SimpleObjectProperty<TextEditor>(); |
| | + |
| | + editor.addListener( ( c, o, n ) -> { |
| | + if( n != null ) { |
| | + mHtmlPreview.setBaseUri( n.getPath() ); |
| | + process( n ); |
| | + } |
| | + } ); |
| | + |
| | + return editor; |
| | + } |
| | + |
| | + /** |
| | + * Returns the tab that contains the given {@link TextEditor}. |
| | + * |
| | + * @param editor The {@link TextEditor} instance to find amongst the tabs. |
| | + * @return The first tab having content that matches the given tab. |
| | + */ |
| | + private Optional<Tab> getTab( final TextEditor editor ) { |
| | + return mTabPanes.values() |
| | + .stream() |
| | + .flatMap( pane -> pane.getTabs().stream() ) |
| | + .filter( tab -> editor.equals( tab.getContent() ) ) |
| | + .findFirst(); |
| | + } |
| | + |
| | + /** |
| | + * Creates a new {@link DefinitionEditor} wrapped in a listener that |
| | + * is used to detect when the active {@link DefinitionEditor} has changed. |
| | + * Upon changing, the {@link #mResolvedMap} is updated and the active |
| | + * text editor is refreshed. |
| | + * |
| | + * @param editor Text editor to update with the revised resolved map. |
| | + * @return A newly configured property that represents the active |
| | + * {@link DefinitionEditor}, never null. |
| | + */ |
| | + private ObjectProperty<TextDefinition> createActiveDefinitionEditor( |
| | + final ObjectProperty<TextEditor> editor ) { |
| | + final var definitions = new SimpleObjectProperty<TextDefinition>(); |
| | + definitions.addListener( ( c, o, n ) -> { |
| | + resolve( n == null ? createDefinitionEditor() : n ); |
| | + process( editor.get() ); |
| | + } ); |
| | + |
| | + return definitions; |
| | + } |
| | + |
| | + /** |
| | + * Instantiates a factory that's responsible for creating new scenes when |
| | + * a tab is dropped outside of any application window. The definition tabs |
| | + * are fairly complex in that only one may be active at any time. When |
| | + * activated, the {@link #mResolvedMap} must be updated to reflect the |
| | + * hierarchy displayed in the {@link DefinitionEditor}. |
| | + * |
| | + * @param activeDefinitionEditor The current {@link DefinitionEditor}. |
| | + * @return An object that listens to {@link DefinitionEditor} tab focus |
| | + * changes. |
| | + */ |
| | + private DefinitionTabSceneFactory createDefinitionTabSceneFactory( |
| | + final ObjectProperty<TextDefinition> activeDefinitionEditor ) { |
| | + return new DefinitionTabSceneFactory( ( tab ) -> { |
| | + assert tab != null; |
| | + |
| | + var node = tab.getContent(); |
| | + if( node instanceof TextDefinition ) { |
| | + activeDefinitionEditor.set( (DefinitionEditor) node ); |
| | + } |
| | + } ); |
| | + } |
| | + |
| | + private DetachableTab createTab( final File file ) { |
| | + final var r = createTextResource( file ); |
| | + final var tab = new DetachableTab( r.getFilename(), r.getNode() ); |
| | + |
| | + r.modifiedProperty().addListener( |
| | + ( c, o, n ) -> tab.setText( r.getFilename() + (n ? "*" : "") ) |
| | + ); |
| | + |
| | + // This is called when either the tab is closed by the user clicking on |
| | + // the tab's close icon or when closing (all) from the file menu. |
| | + tab.setOnClosed( |
| | + ( __ ) -> getRecentFiles().remove( file.getAbsolutePath() ) |
| | + ); |
| | + |
| | + return tab; |
| | + } |
| | + |
| | + /** |
| | + * Creates bins for the different {@link MediaType}s, which eventually are |
| | + * added to the UI as separate tab panes. If ever a general-purpose scene |
| | + * exporter is developed to serialize a scene to an FXML file, this could |
| | + * be replaced by such a class. |
| | + * <p> |
| | + * When binning the files, this makes sure that at least one file exists |
| | + * for every type. If the user has opted to close a particular type (such |
| | + * as the definition pane), the view will suppressed elsewhere. |
| | + * </p> |
| | + * <p> |
| | + * The order that the binned files are returned will be reflected in the |
| | + * order that the corresponding panes are rendered in the UI. Each different |
| | + * {@link MediaType} will be created in its own pane. Order is maintained |
| | + * by using {@link LinkedHashSet} instances. |
| | + * </p> |
| | + * |
| | + * @param paths The file paths to bin by {@link MediaType}. |
| | + * @return An in-order list of files, first by structured definition files, |
| | + * then by plain text documents. |
| | + */ |
| | + private List<File> bin( final SetProperty<String> paths ) { |
| | + // Treat all files destined for the text editor as plain text documents |
| | + // so that they are added to the same pane. Grouping by TEXT_PLAIN is a |
| | + // bit arbitrary, but means explicitly capturing TEXT_PLAIN isn't needed. |
| | + final Function<MediaType, MediaType> bin = |
| | + m -> PLAIN_TEXT_FORMAT.contains( m ) ? TEXT_PLAIN : m; |
| | + |
| | + // Create two groups: YAML files and plain text files. |
| | + final var bins = paths |
| | + .stream() |
| | + .collect( groupingBy( path -> bin.apply( MediaType.valueFrom( path ) ) ) ); |
| | + |
| | + bins.putIfAbsent( TEXT_YAML, List.of( DEFINITION_DEFAULT.toString() ) ); |
| | + bins.putIfAbsent( TEXT_PLAIN, List.of( DOCUMENT_DEFAULT.toString() ) ); |
| | + |
| | + final var result = new ArrayList<File>( paths.size() ); |
| | + |
| | + // Ensure that the same types are listed together (keep insertion order). |
| | + bins.forEach( ( mediaType, files ) -> result.addAll( |
| | + files.stream().map( File::new ).collect( Collectors.toList() ) ) |
| | + ); |
| | + |
| | + return result; |
| | } |
| | |