Skip to content
This repository

A better Java mode for Emacs

README.md

malabar-mode :: A better Java mode for Emacs

malabar-mode extends java-mode with hooks into Maven that make it easy to compile files on the fly and execute Maven build commands.

NOTE: The java/groovy code has been moved to https://github.com/m0smith/malabar-mode-jar

This is based on a fork of buzztaiki's fork of espenhw's malabar-mode which has been merged back into the master branch. Development of malabar-mode has restarted. This is an attempt to keep it up to date and develop at a modest pace.

You may want to skip to Installation.

What malabar-mode offers

Since malabar-mode is derived from java-mode, we get some things for free:

  • Syntax highlighting

  • Movement commands (C-M-f/-b is a winner; so is M-f/-b, especially with c-subword-mode turned on)

  • Electric punctuation

There's lots more; and since this is Emacs, you can turn off or modify anything you don't like.

But there is more:

  • Tight integration with Maven. If you're not using Maven, you should not consider malabar-mode.

  • A Groovy console for rapid prototyping and exploratory programming

  • JUnit integration, both for running tests standalone and through Maven

  • Import help; import one class or all needed classes in the buffer (with prompting if the class name is ambiguous)

  • Extend class / implement interface / override method helpers

  • Simplistic refactorings

  • See the Cheat Sheet

and more.

Installation

The malabar-mode package is now part of MELPA thanks to this issue. Make sure you have the MELPA package archive enabled in your init.el or .emacs and your package contents are up to date (use M-x package-refresh-contents if you can’t find the malabar-mode package and you’ve added MELPA to your package archives.

Prerequisites

Maven

The first time malabar-mode runs it will need to have the mvn executable in the exec-path and access to maven central in order to load its dependencies. Also, starting the first time can take a long time as it downloads needed jars.

Emacs

malabar-mode was originally developed on Emacs 23, but development now targets Emacs 24.

CEDET

A relatively recent CEDET is needed in your Emacs environment. If you have a version of Emacs 23.2 or later, malabar-mode should work fine with the embedded CEDET.

  1. Add the following to your .emacs::

    (require 'cedet)
    (require 'semantic)
    (load "semantic/loaddefs.el")
    (semantic-mode 1);;
    (require 'malabar-mode)
    (add-to-list 'auto-mode-alist '("\\.java\\'" . malabar-mode))       
    

    Alternatively, using Emacs 23.2+ and the embedded CEDET:

    ;; Or enable more if you wish
    (setq semantic-default-submodes '(global-semantic-idle-scheduler-mode
                                      global-semanticdb-minor-mode
                                      global-semantic-idle-summary-mode
                                      global-semantic-mru-bookmark-mode))
    (semantic-mode 1)
    (require 'malabar-mode)
    (setq malabar-groovy-lib-dir "/path/to/malabar/lib")
    (add-to-list 'auto-mode-alist '("\\.java\\'" . malabar-mode))
    
  2. (optional) If you want to mimic the IDEish compile-on-save behaviour, add the following as well::

    (add-hook 'malabar-mode-hook
         (lambda () 
           (add-hook 'after-save-hook 'malabar-compile-file-silently
                      nil t)))
    

Usage

Update: malabar-mode now has a menu. Yay!

Here is a list of available interactive commands, with default keybindings where applicable:

malabar-compile-file (C-c C-v C-c)
Compiles the current file.
malabar-clear-typecache
Clears the type cache (used for code completion) if it gets confused. If you have to use this often, please file a bug.
malabar-extend-class (C-c C-v C-e)
Prompts for a class, adds stub implementations of all that class's abstract methods and accessible constructors and inserts the appropriate extends clause.
malabar-groovy-start
Start the Groovy console, or pop to it if it is running.
malabar-groovy-stop
Kill the Groovy console process.
malabar-implement-interface (C-c C-v C-i)
Prompts for an interface, adds stub implementations of all that interface's methods and adds the interface to the class's implements clause.
malabar-import-all (C-c C-v z)
Adds import statements for all unqualified classes in the buffer, as if by performing malabar-import-one-class on each.
malabar-import-one-class (C-c C-v C-z)

Adds an import statement for a single unqualified class (defaults to the symbol at point). If more than one class matches the unqualified name you will be asked which class to import.

The variable malabar-import-excluded-classes-regexp-list contains a list of regular expressions; if one of these matches the qualified class name, the class will be excluded from import. The default value excludes classes from java.lang, JRE internal classes and inner classes.

malabar-run-maven-command
Prompts for and executes an (almost) arbitrary Maven command line. Honors profile activation, property definitions and lifecycle phases/goals. E.g.: -DskipTests=true -Pdev-mode install will run the install lifecycle with the dev-mode profile active, skipping tests.
malabar-install-project (C-c C-v C-b)
Runs mvn install on your project. With prefix argument (C-u), cleans the project first (mvn clean install).
malabar-override-method (C-c C-v C-o)
Prompts for an eligible method from the superclass of the class at point and adds a stub implementation of that method. If the chosen method is one of Object.equals` or `Object.hashCode, override both of them.
malabar-run-all-tests (C-c C-v M-t)
Runs mvn test on your project. With prefix argument (C-u), cleans the project first (mvn clean test).
malabar-run-junit-test-no-maven (C-c C-v C-t)
Compiles the current file, performs malabar-visit-corresponding-test, compiles that file (if not the same as where we started) and runs the now-current buffer as a standalone JUnit test.
malabar-run-test (C-c C-v t)
Runs the corresponding test to this buffer using Maven (mvn test -Dtest=classname)
malabar-update-package
Updates the package statement of the current buffer to match its place in the source directory.
malabar-visit-corresponding-test

Visits the corresponding test class; that is, the file in the parallel src/test/java hierarchy that matches the class in the current buffer (with malabar-test-class-suffix appended).

E.g., M-x malabar-visit-corresponding-test in a buffer visiting src/main/java/org/grumblesmurf/malabar/MvnServer.java will visit the file src/test/java/org/grumblesmurf/malabar/MvnServerTest.java with the default value of malabar-test-class-suffix.

If the current buffer looks like a test class, this command does nothing.

malabar-visit-project-file (C-c C-v C-p)
Visit the project file, that is the closest file named pom.xml searching upwards in the directory structure.
malabar-jump-to-thing (C-c C-v C-y)
Jumps to the definition of the 'thing' at point. More technically, uses semantic-analyze-current-context output to identify an origin for the code at point, taking type membership into account. This function is much like semantic-ia-fast-jump, only a little smarter.
malabar-refactor-extract-constant (C-c C-v C-r C-c)
Extracts the thing at point as a named constant. The scope of the constant will default to malabar-refactor-extract-constant-default-scope, but with a prefix arg will prompt for the scope.

In addition, standard Semantic code completion is available; trigger this however you wish. By default, semantic-ia-complete-symbol is bound to C-c C-v C-. and semantic-ia-complete-symbol-menu is bound to C-c C-v ..

Abbrevs

Some default abbrevs are set up, see the variable malabar-case-fixed-abbrevs for the current list.

Note the presence of the #Test abbrev; this expands to::

 @Test
 public void |() throws Exception {
     fail("Unfinished test");
 }

With point left at the position marked with |.

Electric expansions

In addition to the electric insertion offered by CC-mode, malabar-mode offers an expansion that simulates the Elvis operator, although the generated code is not as efficient as a language-provided Elvis operator would be. This expansion is controlled by the variable malabar-electric-elvis-p.

This is cool, I want to help

Github has excellent support for forking! Just hit the fork button at the top, code and go. For everyone's convenience, you should probably rebase to m0smith/malabar-mode/master every now and then. :)

If you don't want to go that far, git is, after all, a distributed VCS. Just commit to your local repository and then use git-format-patch to extract patches in a useful format.

But where do I send patches?

To the issue tracker (see the next section).

I found a bug!

Good for you. Create a ticket in the issue tracker and stuff will happen.

Hint #1: Tell me what you did, what you expected to happen and what actually happened. Include any error messages (Emacs backtraces, output in the buffers named starting with *Malabar, interesting stuff from *Messages* etc.).

Hint #2: Bugs with patches tend to be fixed faster (see the previous section).

Wouldn't it be cool if malabar-mode could...

Yes, it probably would! Either describe the feature that you want in the issue tracker, or (even better) fork, code, and ask me to pull.

And of course, if I nix your feature request, you're free to maintain your own local patch branch if you wish (or, for that matter, a complete fork). malabar-mode is Open Source, after all.

Hacking

This fork of malabar-mode uses git-flow to manage branching in development. As such, branches are:

develop
tracks the latest state of development (that isn't occurring in an isolated branch)
master
tracks the latest stable snapshot

Feature, release, feature, hotfix, and support branches won't usually be shared. If they are pushed to github, they shouldn't be rebased but may disappear after they are merged with develop or master.

Emacs environment

Your Emacs environment can be configured to use a "live" version of malabar-mode with the following steps:

  1. Add the following to your .emacs:

    (setq malabar-groovy-lib-dir "~/src/malabar-mode/target/lib") (setq malabar-groovy-extra-classpath '("~/src/malabar-mode/target/classes")) (add-to-list 'load-path "~/src/malabar-mode/src/main/lisp/")

  2. Run mvn package -P devel to extract libraries into target/lib.

With this configuration, you can rebuild malabar-mode's JVM component with mvn compile, which will compile classes into target/classes. To apply these changes, restart malabar-mode in Emacs with M-x malabar-groovy-restart.

After editing elisp files, eval them to apply changes immediately.

Hints for Cygwin

Try

(setq malabar-util-path-separator ";")
(setq malabar-util-path-filter 'cygwin-convert-file-name-to-windows)
(setq malabar-util-groovy-file-filter 'malabar-util-reverse-slash)

Acknowledgments

  • JDEE for being a source of frustration and inspiration (and sometimes of code)
  • Nikolaj Schumacher for fringe-helper and elk-test
  • espenhw for getting the whole thing rolling
  • nflath, stepb and bbatsov for caring enough to help
  • Everybody else for caring enough read this and report bugs

Boring legal stuff

malabar-mode is copyright (c) 2009-2010 Espen Wiborg espenhw@grumblesmurf.org

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

For the full text of the GPL, see http://www.gnu.org/licenses/gpl2.txt.

Something went wrong with that request. Please try again.