Need help with musicbrainz-data?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

lastfm
120 Stars 56 Forks Apache License 2.0 96 Commits 0 Opened issues

Description

MusicBrainz Java data bindings using Hibernate

Services available

!
?

Need anything else?

Contributors list

musicbrainz-data

Java data bindings for the MusicBrainz Database using Hibernate.

Things to know

  • As of now,
    musicbrainz-data
    is meant for read-only access to the MusicBrainz Database. Nothing, however, prevents a user from changing entites; any change might be written to the database and might leave it in an inconsistent state afterwards.
  • Only a subset of the database schema is implemented. Access is provided to artists, releases, tracks and recordings (and related tables).

Configuration

Set some properties for your context

    db.musicbrainz.driver.class=org.postgresql.Driver
    db.musicbrainz.url=jdbc:postgresql://localhost:5432/musicbrainz_db
    db.musicbrainz.user=musicbrainz
    db.musicbrainz.password=musicbrainz

(see

src/main/config/musicbrainz-data.properties.example
for all available options)

Import the musicbrainz-data Spring context:

    

Add the musicbrainz-data dependency:

    
      fm.last
      musicbrainz-data
      3.0.0
    

Usage examples

See the included tests for more examples. The Javadoc can be generated by running

mvn javadoc:javadoc
.

General pattern

    @Component
    public class ArtistHandler {

  private final ArtistDao artistDao;

  @Autowired
  public ArtistHandler(ArtistDao artistDao) {
    this.artistDao = artistDao;
  }

  @Transactional
  public void process(int id) {
    Artist artist = artistDao.getById(id);
    // ...
  }
}

Query for all artists named 'MONO' (casing will be ignored)

    List artists = artistDao.getByName("mono");

Get release with GID 'c69b70bc-049e-3e3f-a5e4-5a1b4d62105f'

    UUID musicBrainzId = UUID.fromString("c69b70bc-049e-3e3f-a5e4-5a1b4d62105f");
    Release release = releaseDao.getByGid(musicBrainzId);

Running the tests

  • Create an empty database
    musicbrainz_musicbrainzdata_unittest
    (as described in the MusicBrainz documentation).
  • Run
    mvn clean verify

Contributing

All contributions are welcome. Please use the Last.fm codeformatting profile found in the

lastfm-oss-config
project for formatting your changes.

Contributors

License

Copyright 2013 Last.fm

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Kthxbye

Last.fm <3 MusicBrainz

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.